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This revision, 093-000081-02, of the Macro Assembler Manual 
constitutes a major manual revision to 093-000081-01 . The 
previous revision contained only those features peculiar to the 
macro assembler; this revision describes all features of the 
macro assembler, including those features common to both the 
macro and extended assemblers. 



INTR.ODUCTION 

The DGC macro assembler is upward compatible with the RDOS extended assembler, 
providing the following added features: 

1. Expanded expression evaluation that provides for explicit as well as 
implicit precedence. The class of operators has been expanded to 
include relational operators. 

2. A class of special symbols having a value (like ". ") related to an 
internal assembler variable. This new class of symbols allows the 
user to determine useful information such as the number of argu- 
ments specified by a current macro call. Further, many pseudo- 
ops have a value associated with them and, using the proper syntax, 
may be used within expressions. 

3. An assembly repeat feature for producing many lines of source from 

a simple repeat construct. This facility also encompasses conditional 
assembly. Conditionals may be nested to any depth. 

4. A powerful macro facility which allows complete recursion as well 
as nested macro calls. 

5. Literal references by any memory reference instruction. All literals 
will be optimally resolved in page zero. Literals are not restricted 
to absolute numeric quantities and, in fact, may consist of any legiti- 
mate expression . 

6. The assembler has the facility to generate three -character alphanumerics 
for each occurrence of the character $ within a label. The facility is im- 
plemented in such a way that, for example, unique labels can be generated 
within nested macros. 



NOTATION CONVENTIONS USED IN THIS MANUAL 
The formats shown in this manual contain certain notations that are not part of the 
Macro Assembler. The notation conventions are: 



< > 



Angle brackets enclose a variable definition of a class. The programmer 
replaces the variable definition with the appropriate atom within the class. 



< variable > 

_ Two or more words may be required for a variable definition. These are 

connected by underscores to indicate that the number of words in the var- 
iable definition is not significant when replacing the variable definition, 
for example: 

.MACRO <user_sym > 

^ ^ represents a carriage return • 

I I represents a form feed. 

upper Parts of the format that are written in upper case letters are literal parts 

case of the Macro Assembly Language and must appear in context exactly as 

letters shown in the format. 

lower Parts of the format that are written in lower case letters are variables 

case indicating that the programmer substitutes an appropriate item within a 

letters class, (user symbol, punctuation character, etc. ) 

f Y Broken square brackets are used to enclose optional parts of a format, 

e.g., 

LDA <exp> <exp> f <exp>f ) 

Three dots indicate an omission of a word or words that should be obvious 
from the format. 



A 



A terminator or break character, defined as any number and combina ■ 
tion of spaces, tabulations, and commas (i.e. , class of space). 



<sp: 



In certain positions a terminator must consist of a single space, a single 
tabulation, or a single comma. A terminator of this type is designated 
<sp> . For example: 

<macro_symbol >■(• A <argl ><sp >. . . <argn >]■ ^ 
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NOTATION CONVENTIONS USED IN THIS MANUAL 



[ } 



Used to designate a terminator that may be written as a single equals 
sign ( = ) or class of space followed by an equal sign (/?f). 

Used to designate a terminator that may be written as a single colon (:) 
or class jf space followed by a colon (A: ). 

Braces indicate alternate choices of formats one of which must be used. 
Where the choices are themselves optional, square brackets with hyphens 
will be used. 



Example: 



^ .DUSR" 
.DIAC 
.DALC 
.DIO 
.DIOA 
.DMR 
.DMRA 

^ .DISD 



► A <user_sym >= <stmt > 1 



NOTATION VARIABLES 
Some of the standard notation variables used throughout this manual are listed below. 



<user_sym > 
<semi_sym > 

<mac_sym> 
<e-xp> 

<stmt> 



Any programmer defined symbol. 

A symbol previously defined as semi -permanent by a 
symbol table pseudo-op. 

A symbol previously defined by the . MACRO pseudo -op. 

An e3q)ression that may consist of symbols, numbers, 
and operators. 

A syntax implicit statement of the form 
< semi_sym > A . . . where < semi_sym > 
is followed by expressions appropriate to the 
type of semi-permanent symbol. 
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CHAPTER 1 
INTRODUCTION TO MACRO ASSEMBLY 
THE ASSEMBLY PROCESS 
Assembly Language 
A language is a set of representations, conventions, and rules used to convey information. 

A marhinp lancriiflcrp is a lanoriiacp HpaionpH tn Hp intpmrrpl 

of numeric codes that can be understood by the computer. 



A marhinp lancrnacrp is a lanoriiacp HpaionpH tn Hp intpmrrpl-prl h^r a rnmniil-p-r anH i«- (^/inoiotc 



An assembly language substitutes symbols for numeric codes. The purpose of an assembly 
language is to ease the task of the programmer by permitting him to write instructions in a 
form that is more meaningful to the programmer and easier foi" him to learn and remember. 
For example, if the programmer wishes to load a value that is stored at a given memory 
address, e.g., 5, into an accumulator, e.g., 0, the numeric code in machine language 
for this instruction to the Nova family computers would be: 



20005 in octal or 0010000000000101 in binary 



It is much easier for the programmer to remember symbolic names rather than numeric codes. 
For example, the instruction can be input to an assembler as: 



LDA 0, 5 



LDA is a symbol, in this case an instruction mnemonic meaning 'load accumulator' . 
The accumulator to be loaded is and the memory address from which the 
accumulator is to be loaded is 5. The address might also have been represented 
by some symbol defined by the programmer. For example, the programmer 
might have defined the address as TEMP and the instruction would have been written: 



LDA 0, TEMP 



Processing of Assembly Language 

A s3rmbolic language, which is meaningful to the programmer, is not meaningful to the 
computer. Therefore, the symbolic assembly language must be translated into machine 
language. The process of translation from sjmibolic assembly language into machine 
language is called assembly , and the program that handles the translation is called 
an assembler . 
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Processing of Assembly Language (Continued) 

The assembler simply substitutes numeric codes for symbolic instruction codes and 
numeric addresses (either absolute or relocatable as defined later) for symbolic addresses. 
There is a one-to-one correspondence between the symbolic instruction format written 
by the programmer and the numeric instruction format generated by the assembler. 
In other words, one line of symbolic instruction will be translated into one line of numeric 
instruction by the assembler. 

The machine language output of assembly must then be processed by the computer 
- executed - to perform the functions desired by the programmer. The assembly 
process only translates symbolic language, called a source program , into machine language, 
called an object program. 

Macro Facility 

When sjmibolic assembly language and use of assemblers are substituted for machine 
language programming, the work of the programmer is simplified. Macro assembly 
is another step in simplifying the writing of a program. 

Quite often a programmer needs to use the same set of symbolic instructions many 
times within his ■"rooram. The basic function of macro assembl'^'^ is to ^^rmit the 
programmer to write a set of instructions only once and then cause those instructions 
to be substituted in his program wherever he wishes. 

Fundamentally, a macro facility works as follows: 

1. The programmer writes a set of symbolic instructions. The set of 
instructions is called a macro definition . The macro definition is 
given a name by the programmer. 

2. Wherever the programmer wants that set of symbolic instructions in 
his program, he writes a macro call. At a minimum, the macro call 
contains the name of the macro definition. 

3. The assembler contains a macro processor which substitutes the sequence 
of instructions (macro definition) for the macro instruction. This 
substitution is called macro expansion . 

The macro facility is in fact much more sophisticated than this. For example, if the 
programmer has a series of instructions that repeat, except for accumulators 
and addresses, the macro definition may contain dummy arguments for the 
accumulators and addresses. The macro call in the program will contain the 
actual arguments to be substituted for the dummy arguments when the macro pro- 
cessor expands the macro. Thus, a macro definition is usually a skeleton of the 
actual instruction set that will result from macro expansion. 
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INPUT AND OUTPUT OF THE ASSEMBLER 



The diagram below shows the input to and the possible outputs from the Macro Assem- 
bler. Input consists of one or more source files written in a subset of the ASCII 
character set. Output includes, at a minimum, a listing of any source program 
errors. Output can consist of a program listing, which includes any errors, a separate 
error listing, and an object file that can be loaded and executed. The object file is in 
a form called relocatable binary. The object file can be loaded by the relocatable 
binary loader for execution. The program and error listings are for programmer 
information purposes. 
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Broken boxes in the diagram represent optional output. 



Assembler Input 

The source program input to the assem.bler consists of character 

of the ASCII character set. The elementary scan of input by the assembler is a line- 
by-line read as follows: 






1. 



Characters scanned up to a carriage return or a form feed 
character constitute a line of source program. 



2. Three characters are unconditionally ignored. These are: 



Character 



null 

line feed 
rubout 



Value 



000 
012 

177 



3. 



Characters having incorrect parity are replaced by the ASCII 
character " \". This character is transparent to higher 
level character processing, i.e. , L\ A is processed as LA. 
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Types of Assembler Output 

There are three possible outputs from assembly: 

1. A relocatable binary object program. 

2. A program listing. 

3. An error listing. 
Relocatable Binary Output 

The relocatable binary output is a translation of the lines of source program into a 
special blocked binary code. Most lines of source input translate into 
a single 16-bit (one-word) binary number for storage in core by the loader. Associ- 
ated with each number is an address. The address associated with the number by 
the a ssembler is not necessarily the final computer address in which the number will 
be stored by the relocatable binary loader; it may be a relative address that is relocated 
by the loader. The assembler produces as part of the object fQe the information needed 
by the loader for mapping each address as well a s the contents of each address. 

The programmer may choose not to output an object file. 

Program Listing 

The program listing permits the programmer to compare his input against the 
assembler output. A line of the program listing contains the following information: 

Columns 1-3 If there are no errors detected in the input, these columns con- 

tain a two-digit line number followed by a blank space. 

If there are any input errors, each error generates a single letter 
code The first error generates a letter code in column 3, the next 
in cJlumn 2, and a third in column 1. Only three error codes can 
be listed per line. If any error code is generated, there will 
be no line number given the line. 

Columns 4-8 The location counter, if relevant. Otherwise the columns are left 

blank. 

Column 9 The relocation flag pertaining to the location counter. 

Columns 10-15 The data field if relevant. Otherwise, the columns are left blank. 

Column 16 The relocation flag pertaining to the data field. 

Column 17 -on The source line as written and as expanded by the possible recogni- 

tion of macros. 
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INPUT AND OUTPUT OF THE ASSEMBLER (Continued) 
Program Listing (Continued) 

An error flag is a single letter indicating the type of error appearing somewhere in 
the source line. A parity error on input, for example, produces the flag I in column 
3 of the program listing line. Up to three error flags may appear on a given line. 
Additional errors will not produce flags. 

The 5 -digit location counter assigned by the assembler to an instruction or datum is 
output in columns 4-8. The location counter (LC) is immediately followed by a single 
character indicating the relocation mode of the address. The location counter flags are: 

Flag Meaning 

space absolute 

page zero relocatable 
= page zero byte relocatable 

normal relocatable 

normal byte relocatable 

Following the location counter is the 6 -column value field which is immediately 
followed by a single character indicating the type of relocatability associated with the 
value. The data value flags are: 

Flag Meaning 

space absolute 

page zero relocatable 
= page zero byte relocatable 

normal relocatable 

normal byte relocatable 
$ displacement field is externally defined 

The last item on the line of program listing is the ASCII source line. The line is 
given as input, except for further expansion that may occur as a result of macro 
calls. 

Certain lines of the listing, for example the expansions of macros, may optionally be 
suppressed by the programmer. 

The programmer may choose not to output a program listing. 
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Cross Reference Listing 

As part of the program listing, the macro assembler produces a cross reference 
listing of the symbol table, which may include user symbols or both user symbols 
and semi-permanent symbols. A sample cross reference listing follows. 

toMvj!? ALPHA 



ALL 
CU 
Lib 
C37 7 

C-i 
C4W 

CHPK 

CMT 

CUtlCM 

mi 

U 1 i! H 
UHd 

FIND 

HfiKE 
1 



C? '^ i? '1 itf 7 - 
« M / '/i i4 I • 

« l.'1 i;l 'A (" ? ■• 

fj t^ k i-i fc? i^ " 
I'l V' t" I*"! !/■ 3 "• 
/i i-" V) y' 1 n ■ 

w3 4v'ilh 

'?! '/ Oi II 1 1 - 

V; ■■' \,i ..I >> ii» 

'.A '/^ ti i:U ■ 3 - 
i/i ti ^1 1/ W 6 



LObT 

LNtCN 
MUVt 

DNt 

KU 

KTN 

SI 

b2 

SORT 

SPACE 

STAR I 

ST6T 



MC 



\ff i/i y 1/1 1 5 •• 

'A I'' ((.1 1 i'l 1 ' 
I'l '/» 1^ i^ 1 H ' 

kO ij 3 J ' 
P) '/i v'.i Oi I 4 •■ 

1/' v< y 1 ti " 

M « VI v1 (/, « » 



tN 



.! 



l/2fi 

I/IO 

a/yi7 
1/ia 
l/'-^l 
\/?J 

1/2 •> 
l/.i7 
1/2'-' 

1 / 2 ■^ 

A i A .\ 
i /■ -4 "-• 

3/>45 
3/ui8 
2/37 
1/29 
6/142 
6/2'/ 
6/37 
1/41 

1/3^ 
4 / 1^ 5 

f)/14 

2/33 
3/»<)4 
1/31 
1/32 
5/i^fi 
1/33 
i/.'14 
1/42 

V 



type of symbol 



relocatability 



symbol location where defined 



5/1^7 
3/17 

3/12 
8/lR 
2/22 
4/lM 

3/^•|« 
6/vl4 

B/3« 
3/21. 
^/3'-i 
b / 1 M 
4/32 
a/27 
3/19 
3/02 
3/07 

t)/i;^9 

fi/9P) 
6/3« 

8/04 
2/13 
4/13 

e>/06 

7/«8 
2/41 

«/U 

8/lb 

e/14 

7/lb 
3/24 

2/09 
fe/13 



5/12 

3/2B 

H/3'.':' 



3/i^Q 
6/13 



fl / y 1 

7/ '-.4 



7/('^i 



4/23 
6/11^ 
S/27 

h/3a 

2/3B 
6/15 



8/13 

a/2'5 

S/24 

4/1X13 
8/46 



3/2 1 

b/v ■> 



%/ii 



6/11. 

t>/2H 
6/4:S 

3/(^2 

6/24 



P/27 



6/31 
7/14 



6/lt 
«/29 

6/4f5 

S/04 
6/33 



3/31 



6/4n 



6/1? 
6/2^ 
6/47 

5/B« 

6/42 



page and line where referenced, e. g. , 

1/26 
♦ t 

page line 
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Cross Rpff^rf^nr^o 1 iQi-i^r^ /■r<„„<.j i\ 

The meaning of the relocatability values given in the cross reference listing is iden- 
tical to those given on page 1-5 for the program listing. 

The symbol types that may appear in the cross reference listing are as follows: 

^ user symbol 

EN entry (. ENT) 

EO overlay entry (. ENTO) 

XD external displacement (. EXTD) 

XN exlernai normal (. EXl'N) 

NC named common (.COMM) 
Error Listing 

Error listing output differs from other assembler output in that a small class of 
errors detected on the first pass over the input wiU be output at that time. During 
the second pass, all errors in the program will be included as part of the program 
listing if the program listing is output. A separate error listing will be output if 
there is no program Usting and is optional if there is a program listing. The separate 
error listing on the second pass is a subset of the program listing containing only 
those lines in which errors were detected. 

The error listing is always to the teletype. 

Processing Input into Output 

The initial reading of a source line is the first step taken in assembly to produce the 
translation into relocatable binary output. To accomplish the translation the 
assembler must: 

1. Build syntactically recognizable elements, called atoms, e.g. , 
numbers, symbols, terminals, etc. 

2. Recognize and act upon the basic atom of each Line, 

RELOCATABILITY 

In relocatable assembly, storage words are assigned a relative location counter 
value. This value is initially zero and is incremented for every storage word 
generated. At the termination of the assembly, if n words have been generated, 
they have been assigned to relative locations 0, 1, . , . , n-1. The actual addresses 
assigned to the words generated are determined at load Fime. The loader maintains 
the value of the lirst location available for loading, "biied on the programs previ- 
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RELOCATABILITY (Continued) 

ously loaded. If we call this value r, then a storage word of relative address a is 
actually loaded at absolute location r+a. 

After the entire binary has been loaded, again assuming it took n words, the loader 
updates its first available location value by 

r' <- r + n 

In this way, any number of separately assembled modules can be loaded together 
without any conflict in absolute storage assignment. This is the major advantage 
of relocatability. The action of the loader is shown in the following diagram. 



Order of Loading 



Core Image 



Relative 


Module A 


Address -* 






A 


n 





Module B 






Module C 









C 


p 





Relocatable 
Loader 



Absolute 
Address -» 




n+m+1 
n + m+2, 



n+m-i-pH-2 



1-8 



CHAPTER 2 
ATOMS 



CHARACTER INPUT 

The input to the assembler is a string of characters. The assembler scans the input 
in one of two input modes: normal mode and string mode. 

String Mode 

In string mode, any ASCII character may be used with no interpretation of the input 
string. String mode is entered in one of three ways. 

1. Comments 

Start of comment: ; 

Terminator: ^ or i 

Example: ;SET MASK BITS i 

2. Macro Definition Strings 

Start of macro string: . MACRO A<usr_sym>^ 
Terminator: % 



Example: 



. MACRO X i 
LDA 0,2 J. 
MOVZL 1,1 ^ 



3. Text Strings 
Start of String: 

Terminator: 
Example: 



.TXT tFtA<a > 
J0_ 

< a > 

. TXT *EXPECTED VALUE= 60% of GROSS $. * 



In this form, < oi> can be any character that is not used in the 
character string, fo the example, the character * is used. 
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Normal Mode 



All other input is in normal mode. In normal mode, the input string consists of char- 
acters from a subset of the ASCII character set, divided into lines. Each line is a 
string of characters terminated by either a carriage return or a form feed. The ASCII 
codes that are recognized by the assembler in normal mode are: 



7 - Bit 




7 - at 




7 -Bit 




7 - Bit 




Octal 




Octal 




Octal 




Octal 




Code 


Character 


Code 


Character 


Code 


Character 


Code 


Character 


014 


FF 


066 


6 


115 


M 


145 


e 


015 


CR 


067 


7 


116 


N 


146 


f 


040 


SP 


070 
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117 





147 
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041 
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071 


9 


120 


P 


150 
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042 


ft 


072 


: 


121 


Q 


151 


i 


043 
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073 


> 


122 


R 


152 
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045 
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074 
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046 
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075 
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124 


T 
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047 
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076 
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125 
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077 
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* 
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A 


130 
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160 
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131 
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s 
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110 
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167 
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062 
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111 


I 


141 
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170 
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3 
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J 
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171 


y 
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4 


113 


K 


143 


c 


172 


z 


065 


5 


114 


L 


144 


d 
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Normal Mode (Continued) 

In normal mode, lower case alphabetics are unconditionally translated to their upper 

case eailivalent. Anv rha-rante^-r nnt -nTii-hi-r, i-^^a c,,Ko^«. -^:..„ i ;r , , 

-j-_. — J ^„w^^^ ^^^^ .Yitxiiii m,^ oujjocL givcii ajjuvc, j.i eiicounterea auring 

assembly, is given a B (bad character) flag and is ignored syntactically. 

In normal mode, the assembler recognizes certain characters and certain groups of 
characters as different types of atoms. The atoms recognized are numbers, terminals, 
symbols, and special atoms. 

ATOMS 

A syntactic element of assembly language recognized by its specific class is called 
an atom. The classes of atoms are: 

1) Terminals 

2) Numbers 

3) Symbols 

4) Special Atoms 



TERMINALS 

A class of atoms, called terminals, serve the general function of separating numbers 
and symbols from other numbers and symbols. A terminal is a single character or 
double character. The terminals are operators and break characters. 

Operators 

Operators are a class of terminals that are used with single precision integers and 
symbols to form expressions. The operators are: 





r^ 


Bit Alignment (shift) 




+ 


Addition 


Arithmetic ^ 


* 


Subtraction 
Multiplication 




/ 


Division 


Logical * 




And 

Or (Inclusive) 




f 


Equal 




>= 


Greater than or equal 


Relational < 


<= 
> 


Less than or equal 
Greater than 




< 


Less than 




<> 


Not equal 
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Operators (Continued) 

The bit shift operator B is distinguishable from a character used in a sjnnbol by the 
atom that precedes it. A bit shift operator is implied if the type of the last atom is 
a single precision integer or if the bit shift operator is immediately preceded by a 
right parenthesis. 

Break Atoms 

The terminals that are used primarily as separators are: 

^ A represents the class of spaces -a space, a comma, a 

tabulation, or any number or combination of spaces, commas, 
and tabulations. The meaning of A is changed if followed 
immediately by a colon or equals sign (: or = ) as defined 
below. 

: A colon (or the class of colons, A :) is one means used to 

define the symbol preceding 

<usr_sym>: 

An equal sign (or the class of equal signs, A=) is another 
means of defining the symbol preceding 

<usr sym>= 

( ) Parentheses may enclose a symbol or an expression. 

[ ] Square brackets may endbse the actual arguments of a macro 

call. 

; A semicolon indicates the beginning of a comment string. 

^ A carriage return terminates a Line of source code. 

I A form feed terminates a line of source code. 
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NUMBERS 

Tliree types of numbers are defined for the Macro Assembler. These are: 

1 ) Single precision integer - stored in one word 

2) Double precision integer - stored in two words 

3) Single precision floating point constant - stored in two words 

Representation of Numbers 

A single precision integer is represented as a single word of 16 bitis, having the 
range O-bSSaS^Q (0-1777778). The integer may be interpreted as signed using 
two's complement arithmetic in which bit indicates a positive integer if and a 
negative integer if 1 . 



1 



15 



A double precision integer is represented in core in two contiguous words, where 
the first word is the high order word. Using two's complement notation, a double 
precision integer is represented as: 



, s ; 



■^high order 
*-low order 



15 

where: bit of the high order word is the sign bit. 

A single precision floating point constant is represented in core in two contiguous words 
having the format: 



s ; integer characteristic 



mantissa 







7 8 



31 



where: £ is the sign, = + and 1 = - 

The integer characteristic is the integer exponent of 16 in excess 
64jQ (lOOg) code. Exponents from -64 to +63 are represented by the 
binary equivalents of 0-127^0 (0-177g) . An exponent of zero is repre- 
sented as lOOg. 

The mantissa is represented as a 24-bit binary fraction. It is convenient 
to view the binary fraction as six, 4-bit hexadecimal digits. The range 
of the magnitude of the mantissa is: 

16"1 ^ mantissa ^ (1-16-6) 

The negative of a number is obtained by complementing bit (from to 1 or 1 to 0). The 
characteristic and mantissa remain the same. When an expression evaluates to zero. 
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Representation of Numbers (Continued) 

it is represented as true zero, i.e. , two words of all zeroes in sign, characteristic, 
and mantissa bit positions. 

The range of magnitude of a floating point number is: 

16-1 * 16-64 ^floating-number < (1-16-6) * 16^3 

which is approximately 

5.4 * 10-'79 < floating-number <7.2 * lO^^ 

Most routines that process floating point numbers assume that all nonzero operands 
are normalized, and they normalize a nonzero result. A floating point number is 
considered normalized if the fraction is greater than or equal to 1/16 and less than 1; 
in other words it has a 1 in the first four bits (8-11) of the high order word. All 
floating point conversions by the assembler are normalized. 

Use of Numbers 

Single precision integers may appear inexpressions and data statements, while double 
precision integers and floating point numbers may appear only in.data statements 

Source Representation of Numbers 

Single Precision Integers 

The source format of a single precision integer is: 



£+}d{d...dH.}<break> 



where: each d is a digit within the range of the current input radix. The 
initial d must be in the range 0-9. 

<break> is any character other than a digit within the range of 
the current radix or a " . " . 

If a decimal point precedes the break character, the integer is evaluated as decimal. 
If there is no decimal point, the integer will be evaluated in the current mput radix 
as set by the programmer. The range of input radix values is 2 through 20 as set by 
the . RDX pseudo-op. The representation of digits is shown in the table following. 
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Single Precision Integers (Continued) 















Digit 


Representation 


Digit Value 


Hadix Must 
Be > 


HUigit Representation 


Digit Value 


Radix Must 
Be> 










any 


A 


10 


11 




1 


1 


any 


B 


11 


12 




2 


2 


3 


C 


12 


13 




3 


3 


4 


D 


13 


14 




4 


4 


5 


E 


14 


15 




5 


5 


6 


F 


15 


16 




6 


6 


7 


G 


16 


17 




7 


7 


8 


H 


17 


18 




8 


8 


9 


I 


18 


19 




9 


9 


10 


J 


19 


20 



If the input radix is 11 or greater, a number that would normally begin with a letter 
must be preceded by an intial to distinguish the number from a symbol, e g 
to represent the decimal numbers, 15, 255, 4095, and 65, 535 in hexadecimal- " 



300020 
000017 
000377 
007777 
177777 



.P.DX 

0F 

0FF 

0FFF 

0FFFF 



16 



The < break > character normally terminating the single precision integer is one of 
the following characters: 



1. Operator: 



+ - */B 

! & 

== <> <= 



>= > < 



2. Terminal: 
Note the following exception: 



A ) ) 



The operator B (bit shift operator) wiH be interpreted, as a digit if 
the radix is 12 or greater. To obtain the correct interpretation as a bit 
operator, the programmer must use the *- convention. The *- acts as 
a break character to the number string and is then ignored. 



000020 .PDX 15 
025423 02E13 
000010 02-B13 



B REPRESENTS DIGIT 11 

B REPRESENTS BIT SHIFT OPERATOR 
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Single Precision Integers (Continued) 

Within an expression, one integer might have the current radix and another might 
be given in radix 10 using the decimal point convention. Some examples of assem- 
bled values of expressions in which single precision integers of different radixes are 
used are shown below. 



300002 .^DX 2 

0210012 101+101 

000010 .PDX 3 

000202 101+101 

0000 12 .HDX 10 

000312 101+131 

000320 .PDX 16 

001002 101+101 



Special Formats of Single Precision hitegers 

There is a special input format that is converted to the single precision 7 -bit octal 
value for the single ASCII character following. The input format is: 



"3 



where: a represents any ASCII character except line feed (012g), rubout (ITTg), 

or null (000). 

Only the single ASCII character immediately following the quotation mark is inter- 
preted. The ASCII characters, null, rubout, and line feed, which are invisible to the 
Macro Assembler, cannot be input using this format. However, the other 
ASCII characters can be represented as single precision integer in this manner. 



000101 "A 

000065 "5 

000045 ■■% 

000 13A "X 



The format can be used as an operand within an expression as shown. 



000103 "A+2 
000026 "E/3 
177751 "^-''A 



Note that ">' assembles an octal 15 and also terminates the line. 
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Special Formats of Single Precision Integers 

A second format can be used to convert up to two ASCII characters to a single 
precision integer. The format is: 



'<string>' or 



'string ^ 



where* <sfrino'> ran rnnsist nf anv niimhfs-r nf A.QPTT nha-rnr^i-ovc!' r\■n^\T tha 

first two characters are used to generate a 16 bit value. 
Characters are packed left-to-right in the word: 



•AB' 



•A' 






A 





B 


1 789 


15 





A 






1 78 



15 



Note that packing of '< string>' contrasts with packing of a single ASCII character 
that is input using the " « format. Such a character is stored 









a 







7 8 9 



15 



A string format consisting of two apostrophes without an intervening character will 
generate a word containing absolute zero. 

Special formats of single precision integers may be used in any context that integers 
are allowed. The values of some simple expressions using string constants are given 
below. 



040502 'AB' 
041101 ♦BA* 
000000 ♦ • 
000003 ••+5-2 
041005 'B'+S 
020101 ' A^ 
040501 "A+»A» 



If a carriage return is encountered before the second ' , the string is 
terminated. For example: 



006400 • 
040415 •A 
040502 •AB 
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Double Precision Integers 

A double precision integer has the following source format: 



{+Jd-[dd...dH.}D <break> 



where: each d is a digit within the current radix. The initial d must 
be in the range 0-9 . 

The character D before the break character indicates a double 
precision integer. 

The optional decimal point is used to indicate that the integer 
is converted in decimal. 

<break> is a terminal character that indicates the end of the 
double precision integer. 

The break character is typically one of the terminals: 

A ; ^ 

Operators may not terminate double precision integers (a format error results). 

The radix of a double precision integer may be in the range 2 - 20 . If the radix is 
greater than or equal to 14, the letter D will be interpreted as a digit. To force the 
assembler to interpret D as indicating double precision, use the — convention, e.g. , 



300020 .RDX 16 

000/455 12D ;D IS INTERPRETED AS THE DIGIT 13 

000000 12-D ;D IS INTERPRETED AS SIGNALIMG THAT 

000022 i\2 IS A DOUBLE PRECISION INTEGER 



Some examples of assembled values of data statements containing double precision 
integers are: 



3003 10 .RDX 3 

030030 ID 

000001 

177777 -ID 

177777 

000001 200000D 

000000 

300003 2621''47.D 

000003 

000001 100000. D 

1032^40 
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Single Precision Floating Point Constants 

Much of the floating point number format is optional. The minimal format recognizable 
as a floating point number must consist of at least one digit in the range 0-9 followed by 
either a decimal point or the letter E followed by at least one digit in the range 0-9. 
The minimal floating point format is: 




where: d is a digit in the range - 9 . 
A single precision floating point number is represented in source format as: 



where: 



{±}d{d...d}.d{d...d} [e ■{+}dfdj]' 
{±Jd{d...djE{+].d{d3- 



<break> 



each d is a digit - 9 . The mantissa and exponent are always converted 
In decimal, e.g. , 2E9 =^ 2 * 109 . 

One or two digits may represent an exponent following the letter E. 

Equivalent floating point numbers may be formatted using either the letter 
E or the decimal point or both as shown below 
I — 

I 1 /; 1 T7 <i _ o c /, MO 

14137 6 -25A,33FJ1 

'■^52172 

14137 6 -P.5AP,3K-0P. 

•'15^172 

14137 6 -P.5A33E-P. 

nspiip 

141376 -2543. 3E-1 
'■5R172 



< break > is typically one of the terminals: 

A ) '. 
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Single Precision Floating Point Constants (Continued) 

If the current radix is radix 15 or larger, a letter E appearing in a number can 
cause interpretation of the number as an integer in the current radix rather than 
as a floating point number. To avoid this ambiguity, use the *- convention, for 
example, 



.PDX 16 
155035 -25E3 JE IS HEXADECIMAL 14 

142141 -25-E3 IE INDICATES FLOATING POINT 
124000 



Some examples of floating point constants in data statements with their stored 
values are: 



040420 


1.0 


000030 




040462 


3.14159 26 


04 1766 




140420 


-1E0 


000000 




040200 


+5.0E-1 


030000 




041421 


+273. 0E0 


010000 




Examples 


of Numbers 



Following are some additional examples of the format of source program numbers 
and their assembled value. 
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Examples of Numbers (Continued) 



300320 .RDX 16 

f^53175 567D JHEXADECIMAL SINGLE PRECISION INTEGEP 

........... :v ^^,-.^ ^ i-ic/viiur^uirjHi^ JUULibLt PHECISIOW INTEGER 

001067 567. .-DECIMAL SINGLE PPECISIOM INTEGER 

■300000 567. -D ; DECIMAL DOUBLE PRECISION INTEG"R 
0731367 

(7i5!P^/j7 ^^^7 • ut?v Ar^r•/^T•..^ AT ^,.,„. „ 

--■ . .i--^w-i^i:,ui;-ii-li^ DilMljUJL I-'KfcUIblUN INTEGER 

053175 567D ;HEXADECIIiAL SINGLE PRECISION INTEGER 

005316 567-B14 ^HEXADECIMAL SINGLE PRECISION INTEGET', BIT 

; SHIFTED ONE BIT 

012634 567-B13 .'HEXADECIMAL SINGLE PRECISTON TMTEGER, «tt 

.'SHIFTED TWO BITS 

042026 567-El .'FLOATING POINT CONSTAMT (Di^'CP-'fAL) 

023000 " ' 



SYMBOLS 



A primary function of the assembler is the recognition and interpretation of symbols. 
Symbols are used both to direct the action of the assembler and to represent numeric 
values. The various classes of symbols will be discussed in Chapter 3. Their source 
representation is given below. 



af b ... b3 < break > 



where: a is one of the characters A-Z , ? 

b is one of the characters A-Z , ? 0-9 

< break > is any character other than A - Z - 9 . ? 

If more than five characters precede the < break > character, only 
the first five are regarded as significant. 

? as the first character of a symbol should not be used. It will be used by DGC in 
system macros to "guarantee" uniqueness of macro names. 
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SPECIAL ATOMS 

There are three atoms that are transp^ent during the assembly scaUo The effect of 
these atoms upon a line occurs after the entire line has been scanned, 

@ An at sign (@) or any number of at signs appearing anywhere in a source pro- 

gram line of a memory reference instruction (MRI) or before an expression 
has the following effect. 

1) When the rest of the MRI has been evaluated, presence of the @ 
sign or a series of @ signs anywhere in the instruction causes a 1 to be 
stored in bit 5. In the format of a memory reference instruction, bit 
5 is the indirect addressing bit. 



0245520 LDA 1^20 
026020 LDA 1,©20 



2) In the format of a data word, bit is the indirect 

addressing bit. When the expression has been evaluated, presence of 

the @ sign or series of @ signs causes bit zero of the word to be set 

tol. 



000025 25 
103025 ©25 



A pound sign (#) or any number of pound signs appearing anywhere in a 
source program line of an arithmetic and logical instruction (ALC) has the 
following effect. 

When the rest of the ALC has been evaluated, a 1 is stored in bit 12. 
(Bit 12 in the format of the ALC is the no load bit. ) 
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SPECIAL ATOMS (Continued) 



Two consecutive asterisks appearing anywhere in a source program line 
(or any series of two or more asterisks) cause the suppression of listing 
of that line. 



LDA 0>fc;,2 
LDA fi,0, 3** 
LDA 0,0,3 
. EiM D 



) 

J 



00000 0S1000 LDA !^,0,2 I 
00902 021400 LDA 0,0,3 ? 
.END J 



source program 



listing 



The atom may occur anywhere in the line. For example, all of the 
following would suppress the listing of . NOMAC. 



**.iMOMAC 1 
.iMO'MAC 1** 
•NO MAC** 1 
.NOMAC **1 
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CHAPTER 3 



SYNTAX 



EXPRESSIONS 



An expression <exp> has the format: 



{ <opn J >J<opr ><opn2 



> 



where : 



< opr > is a macro assembler operator. 

<opnj> and<opn2> ^^^ operands which may be single precision 
integers or symbols or expressions evaluating to single precision 
integers. An operand preceding the operator is necessary for 
each operator, except for unary operators + and -. Either unary 
operator may follow an operator or precede an expression. 



The macro assembler operators are: 



Operator 

B 

+ 

* 

I 
& 



< > 

< = 
< 
>= 
> 



Meaning 

Bit alignment 

Addition or plus 

Subtraction or minus 

Multiplication 

Division 

Logical AND. The result in a given bit 

position is 1 if and only if <opn,> = 1 

and <opn2> = 1 in that bit position. 

Inclusive OR. The result in a given bit 

position is 1 if either <opn]_> or <opnp> 

or both is 1 in that bit position. 

Equal to 

Not equal to 

Less than or equal to 

Less than 

Greater than or equal to 

Greater than 
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EXPRESSIONS (Continued) 

Operators of more than one type may appear in an expression. Order of evaluation 
depends upon the precedence of the operators: 

Operator Precedence Level 

B 3 (highest precedence) 

+ -*/&! 2 

< <= > >= == <> 1 (lowest precedence) 

When operators are of equal precedence, the operators proceed from left to right. 
Parentheses around an expression may be used to alter precedence; an expression 
in parentheses is evaluated first. 

Expressions are evaluated with no check for overflow. 
Expressions Evaluating to Zero or One 
An expression containing one of the operators 

== <> <=<>=> 

evaluates either to absolute zero or absolute one. 
Examples : 



000025 A=25 

177763 3=-15 

SS0000 A==B 

00S00 1 A<>E 

(?00001 A+E-10= = A-C2*l(Zi+5) 

000001 A==<-B)+ig 

000000 A<>(-B)+10 

000000 A==(-B)&A 
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Bit Alignment Operator 

vviicii Liic jjiL tijLigiiiiiciiL ujjt;id.iur iH usea, cne operana <opni> preceding operator 
B is the value that is to be aligned. The operand <opn2 > following the operator 
represents the rightmost bit to which <opni > is aligned. The value of <opn2> 
has the range: 

< <opn2 > < 15^0 

The formula for determining the result of a bit alignment operation is as follows: 

for <opni>B<opn2 >, the resultant value will be 

<opni>*2**(15. - <opn2>) 

where: <opn2> is implicitly evaluated in decimal unless 
parentheses are used, e. g. , 

.RDX 8 
1B15 = 000001 
18(15) = 000004 

The operator B can be misread as a symbol or part of a symbol. If the operand 
preceding the operator is a symbol, the operand must be enclosed in parentheses 
to avoid this misinterpretation. Some examples of bit alignment operations are: 



000025 A=25 

00002 1000S0 (A)B0 

O(d006 124SS0 (A)B4 

00011 012409 <A)B7 

00S17 000124 CA)B13 

Qe;j21 000025 (A) CI 5 

N00022 000000 (A) El 6 



Parentheses around <opnj>and <opn2> can be used to insure that the correct 
value is aligned properly. The effect of parenthesized operands is shown below. 



t?00025 A=25 
003010 C=10 

000640 <A-G)*2BC3+C) 
000640 <A-C*2)B(3+C) 
177425 A-<C*2)E(3+C) 
000640 A-C=l=2B<3+C) 
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Examples of Expressions 

Some examples of expression evaluation are: 



000025 A=25 

0000 15 3=15 

0000B 000010 A*(i:-10)/3 

.7>0001 000015 Ai3/A!D 

00032 000001 <A-10)==B 

00003 000015 A/B+B 

0000/4 000000 A&B/(A!3) 

00005 000001 (C3/A)+5)>3 



Relocation Properties of Expressions 

Associated with each operand of an expression is its relocation property, and the 
relocation property of the result of evaluation of an expression will depend upon 
the relocation properties of the operands. Expressions described thus far have 
had absolute operands and the result of evaluation has been absolute. 

A value, however, may have one of several relocation properties. These are: 

absolute 

page zero relocatable 
page zero byte relocatable 
normal relocatable 
normal byte relocatable 

The relocatable value is converted to absolute during the loading process by the 
addition of a constant, c, called a relocation constant. A relocation constant is 
added once if the value is singly relocatable and twice if the value is doubly 
relocatable (byte relocatable). 

Two relocation constants are maintained by the loader, the normal relocation 
constant and the page zero relocation constant. In RDOS the initial value of 
the page zero relocation constant is 50, while the initial value of the normal 
relocation constant is variable but can be found in the User Status Table (UST) at 
location USTIN. 

Page zero relocatable and normal relocatable operands cannot both be operands of 
a given expression. However, some mixing of like relocation properties is 
permitted. The relocation properties of operands and the relocation value of the 
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Kelocation JrTopertles of hixpressions ((Jontinued) 
result are given below. In the list, 

a represents an absolute value 

r represents a relocatable value (either ZREL or NREL) 

2r represents a byte relocatable value (either ZREL or NREL) 

kr represents a relocatable value that can be converted to 

an absolute quantity by addition of a relocation constant, 
c, k times. However, if the final value of a expression 
is k- relocatable, the statement is flagged with a 
relocation error (R). 



Expression 


Relocation 


a+a 


a 


a+r 


r 


r-Hr 


2r 


nr+-mr 


(n+m)r 


a-a 


a 


r-a 


r 


a-r 


-Ir 


r-r 


a 


nr-mr 


(n-m)r 


a*a 


a 


a*r 


ar 


r*r 


Illegal 


a/a 


a 


kr/a 


kr (0 



^ r (only if k/a yields no remainder) 
a 



a/r Illegal 



a&a a 

ala a 

r&r Illegal 

a&r Illegal 

r!r Illegal 

air Illegal 
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Relocation Properties of Expressions (Continued) 

All expressions involving the operators <<>>== <> result in an absolute value 
of zero (false) or one (true). When operands of these expressions are of differing 
relocation properties, all comparisons will result in a value of absolute zero 
(false) except when the operator is <> (not equal to). 

Expressions evaluated using the rules given that result in a value of a, r, or 2r 
are legal. Expressions that do not evaluate to a legal relocation property 
will be flagged as relocation errors (R). 

An example showing the relocation properties of expressions is given below. The 
assembler map indicating the relocation properties of^each symbol is included. 



000002 A=2 ;a is absolute 

.rjREL 
00000 '000020' .+20 

00001 '000000 R: ;r is relocatable 

000002 'S=R+1 J RELOCATABLE + ABSOLUTE IS RELOCATABLE 
00002 '00000 1 A/A J ABSOLUTE OPERATOR ABSOLUTE RESULTS IN ABSOLUTE 
00003' 000002"R+R J RELOCATABLE + RELOCATABLE IS BYTE RELOCATABLE 
0000A' 177777 'R-A ; RELOCATABLE - ABSOLUTE IS RELOCATABLE 
00005*000001 S-R JRELOCATABLE - RELOCATABLE IS ABSOLUTE 
R0000&' 000000 'A! R ; OPERATORS & .vm ! MUST BE USED WITH ABSOLUTE 

; OPERANDS 
000 1 I '00000 1 • ( A>i<R) /A ;N0 REMAINDER 



END 



0002 .MAIN 



000002 1/01 1/06 1/06 1/08 1/13 i/12 1/13 

1/14 1/14 

R 000001' 1/04 1/05 1/07 1/07 ^ 1/08 1/09 1/10 

1/12 1/13 1/14 

S 000002' 1/05 1/09 
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SYMBOLS 

Symbols recognized by the macro assembler are classified as: 

1 . Permanent 

2. Semi -permanent 

3. User 

The distinction between these classes is essential to the understanding of the 
assembly process. 

Permanent Symbols 

Permanent symbols are defined within the assembler and cannot be altered in any 
way. These symbols are used for two purposes: 1) they are used to direct the 
assembly process; and 2) they are used to represent numeric values of internal 
assembler variables. 

Symbols used to direct the assembly process are called pseudo-ops. Pseudo-ops 
are used for such purposes as setting the input radix for numeric conversions, 
setting the location counter mode, assembling ASCII text, etc. They are discussed 
in detail in Chapter 4. 

A number of permanent symbols represent numeric values of internal assembler 
variables. For example, the symbol . PASS is used to represent the current pass 
number. On the first assembly pass its value is 0, while on the second its value 
is 1. If a symbol can be used both as a pseudo-op and as a value, the assembler 
recognizes which use is intended by the context in which it is used. 

This is determined as follows; 

1. If the first atom of a line is a pseudo-op, it is used to direct 
the assembler. 

2. If the occurrence of the pseudo-op atom is in any other 
position within the line, its value is used. 

A few examples will illustrate these rules. 

The assembler has a pseudo-op, . TXTM, used to direct the packing of text bytes 
within a word. The two methods are left/right and right/left. The directive takes 
the form: 

.TXTM <exp> 
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SYMBOLS (Continued) 

Permanent Symbols (Continued) 

If <exp> evaluates to zero (the default mode), bytes are packed right/left. If 
<exp> evaluates to non-zero, bytes are packed left/right. 



Example 1 



Example 2 



The line 

.TXTM 1 ) 
directs the assembler to pack bytes left/right. 



The line 

(.TXTM) ) 

assembles a storage word containing the value of the last 
expression used to set the text mode. 



Example 3 



If the following are given, 

S0S001 .T"TM 1 
00000 000005 +.TXTM+4 

The first line sets text mode to pack left/right while the second 
line generates a storage word containing absolute 5. (Note that the 
first atom of the second line is +, ) 

A list of all permanent symbols is given in Appendix F. These symbols cannot be 
redefined and must be used as described in this document. These symbols will 
never be printed as part of the user' s symbol table. 

Semi-permanent Symbols 

Semi -permanent symbols form a very important class usually thought of as 
operation codes . Using appropriate pseudo-ops, symbols may be defined as semi- 
permanent; and their future use implies further syntax analysis. For example, a 
sjnnbol may be defined as "requiring an accumulator". Use of this symbol causes 
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Semi-permanent Symbols (Continued) 

the assembler to scan for an expression following the symbol. If not found, a for- 
mat error results. If found, the value of the expression determines the value of 
the accumulator field bit positions to give a 16 -bit statement value. Statements are 
discussed fully in the next section. 

^ ^^^...^w^xx^ii^ v^j,ii.ij.n^j.t. <^aiL ijc oavcu etiiu uacu, wiLHout reoeimition, ror all sub- 
sequent assemblies. The assembler supplied by DGC contains a number of semi- 
permanent symbols defined specifically to conform to the Nova family instruction 
set. A list of these symbols is given in Appendix E. The user can eliminate these 
symbols and define his own set, or, more commonly, he can add to the given set. 
(See Chapter 6. ) 

Semi-permanent symbols will, by default, not be printed as part of the user's 
symbol table but can be printed if enabled by the global /A switch (see Operating 
Procedures, Chapter 6. ) 

User Symbols 

The user can define any symbol that does not conflict with the permanent or semi- 
permanent symbols. Symbolic definitions are used for many reasons: to 
symbolically name a location, to assign a numeric parameter to a symbol, to name 
external values, to define global values, etc. These user symbols are maintained 
for the duration of an assembly in a disk file symbol table that is printed after the 
assembly source listing. 

User symbols can be further classified as local or global. Local symbols have a 
value which is known only for the duration of the single assembly in which they are 
defined. Global symbols have a value which is known at load time, i.e. , they are 
used for interprogram communication. 

STATEMENTS 

In discussing source line syntax, the concept of a statement must be clearly 
understood. A statement, in the context of this manual, is the assembly of one 
or more fields, initiated by the occurrence of a semi -permanent symbol*, to form 
a 16 -bit value with relocation. Fields are separated by the class of space, A , This 
16-bit value need not generate a storage word, i.e. , cause the location counter to be 
incremented. A statement is terminated by the successful assembly of the neces- 
sary number of fields as determined implicitly by the type of semi -permanent symbol. 



* Except a . DUSR semi -permanent symbol. 
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STATEMENTS (Continued) 

The Nova family of computers recognizes six basic instruction formats. Correspond- 
ing to each format is a pseudo-op enabling the definition of a semi-permanent symbol 
requiring fields appropriate to each format. Statements then fall into one of six 
formats: 

1. Arithmetic and Logical 

2. Input/Output 

3. Input/ Output with Accumulator 

4. Instruction with Accumulator 

5. Memory Reference 

6. Memory Reference with Accumulator 

The instructions corresponding to these statement types are discussed fully in 
"How to Use the Nova Computers. " The syntax required for each statement type 
is given below. (Note that the semi-permanent symbols listed are those defined 
by DGC. ) 

ALC Statements 

ALC statements are implied wherever the semi -permanent symbol is one of the 
following: 

ADC 

ADD 

AND 

COM 

INC 

MOV 

NEC 

SUB 

Any one of these symbols will be represented as 

<alc> 

The ALC statement format is: 



<alc>fcry sh>3 A <src> A < des>t A < skp> ^ 
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ALC Statements (Continued) 

where: <alc> is one of the semi -permanent ALC statement symbols. 

<cry_sh> represents the optional carry bits and shift options. 

< sro and < des> represent the source and destination accumula- 
tors, respectively. 

<skp > represents the optional skip field. 

The special character # may appear as a separator for any field and forces bit 12 
of the value to be 1 (no-load). The <src>, <des>, and <skp> fields can be 
specified by any legal expression. The optional <cry_sh> field must be one of the 
following alternatives: 

< cry_sh> 

Z 

O 

C 

L 

R 

S 

ZL 

ZR 

ZS 

OL 

OR 

OS 

CL 

CR 

CS 

Carry bias and shift options, as well as the other fields of the ALC statement, are 
described in "How to Use the Nova Computers. " 

Some ALC statements are: 



ADD 


0,1 


SUB 


2,3,SKP 


ADC# 


2,1 


NEGZL 


1,0, SBN 


COM 


1,0,#SZC 
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STATEMENTS (Continued) 
Input/Output Statements 

Input/output statements without an accumulator are implied whenever the semi- 
permanent symbol is one of the following: 

NIO 

SKPBN 

SKPBZ 

SKPDN 

SKPDZ 

Input/output statements with an accumulator are implied whenever the semi-per- 
manent symbol is one of the following: 

DIA 

DOA 

DIB 

DOB 

DIG 

DOC 

The format for an I/O statement without an accumulator is: 



NIOt<pls >3 A<dvc > 



or 



<io> A<dvc> 



where: <pls> is the optional pulse specification, S, C, or P. 

<dvc> is any legal assembler expression specifying a device code. 

<io> is one of the semi -permanent symbols SKPBN, SKPBZ, SKPDN, 
or SKPDZ. 

The format for an I/O statement with an accumulator is: 



<ioa>§<pls> ^ A <ac > & < dvO 



3-12 



b J.AX£i.Mti.iM& (uontinuea) 

Input/Output Statements (Continued) 

where: <ioa> is one of the semi -permanent symbols for an I/O statement 
with an accumulator. 

<pls> is the optional pulse specification, S, C, or P. 

<ac> is any legal assembler expression specifying an accumulator. 

<dvc> is any legal assembler expression specifying a device code. 

Some examples of I/O statements are: 



NIO TTI 

NIOS PTR 

DOAS 0, FTP 

SKPBZ TTI 

DIA 2, CPU 



Instructions with an Accumulator 

The semi -permanent symbols below require an accumulator specification: 

INTA 

MSKO 

READS 

The format for an instruction with an accumulator is: 



<iac> A<ac> 



where: <ac> is any legal expression specifying an accumulator. 
For example; 



READS 1 
MSKO 3 
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STATEMENTS (Continued) 

Memory Reference Statements 

Memory reference statements not requiring an accumulator are: 

DSZ 
ISZ 
JMP 
JSR 

Those requiring an accumulator are: 

LDA 

STA 

Two formats can be used for memory reference instructions. They are 



1. <mr> Af <ac> A^ <dsp > A <ndx> 

2. <mr> Af <ac> A^ <adr> 



In the first format: <ac> is any legal expression specifying an accumulator. It 

is given for LDA and STA statements. 

<ndx> represents an index field and its value must be 
0, 1, 2, or 3. 

<dsp> represents a displacement that, for index modes 
1,2, and 3, must be in the range 

-200 .LE. <dsp> .LT. 200 

and for index mode must be in the range 

.LE. <dsp> .LT. 400 

Normally, indexing is based on AC2 or AC3. Occasionally, however, index 
mode 1 is used to force PC relative addressing. Using explicit index mode is 
unheard of. 

The second form of address specification is most common. Using this form, the 
assembler attempts to form a correct address representation according to the 
flow chart shown on page 3- 16 . The final index mode for this implicit type 
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STATEMENTS (Continued) 

Memory Reference Statements (Continued) 

addressing is either (page zero) or 1 (PC relative). 

The basis for this type of address representation is to simplify the specification for 



thp 



iic<=>-r 



If the address is addressable directly (. ZREL or . EXTD), the index field is set 
to 00 and the displacement field is set as follows: 

1. If absolute, to the <adr> value (0 to 377) with absolute relocation. 

2. If page zero relative (.ZREL), to the relative address <adr>with 
page zero relocation. 

3. If external displacement (. EXTD), to the external' s ordinal value 
(1 to 377) with external displacement relocation. 

However, if the <adr> is not directly addressable but is of the same relocation as 
the current relocation counter and is within addressable range, then the index field 
is set to 01 and an absolute displacement is computed as 

<adr> - LC 
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ADDRESS EVALUATION 



<nclx> *- 00 
<dsp> -^<adr> 
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STATEMENTS (Continued) 

Semi -Permanent Symbols with No Field Specifications 

The discussion of statement types would not be complete without mentioning the 
one type of semi -permanent symbol that represents a 16 -bit value and requires no 
additional field specification. A number of these symbols are defined and can 
be used simply as operands within expressions. 

For example, these symbols represent: 

1. Skip mnemonics 

SKP 
SZR 

SNR 

szc 

SNC 
SBN 
SEZ 

2. Device codes, e.g., 

TTI 
TTO 
PTR 
FTP 

3. Self -complete instructions, e.g. , 

INTEN 
INTDS 
lORST 
HALT 
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ASSEMBLY 

Having discussed expressions and statements, the line by line assembly scan 
to produce relocatable binary output can now be described. The majority of 
source lines effect the generation of a 16-bit value with relocation properties 
that is to occupy a memory location at execution time. Any line of this type 
is said to produce a storage word . The storage word has a value, usually 
defined by an expression or statement, and an address. At assembly time, 
the address assigned is the current location coimter (LC) and, as discussed 
earlier, this LC may be absolute, relocatable within page zero (ZREL), or 
relocatable outside page zero (NREL). The generation of each 16-bit storage 
word causes the LC to be incremented by one. Thus, in general, storage words 
are assigned to consecutive, increasing LC values. 

Labels 

The programmer often needs to name a storage word symbolically. This 

n11^„rr. Uim «-,-. ^cfQ^oti/^o tVioco ^i/dTTla -inri fVini it" T-PTraT-H friT tVipir flSSPrnbler dc- 

fined numeric address. The value of the current location counter can be 
assigned to a user symbol at the start of any source line using the following 
syntax: 



< usr sym> 



The value of < usr sym > will, therefore, be the address of the next storage 
word assembled. Since some assembler lines do not generate storage words, 
this definition is not necessarily associated with the statement that it appears 
within. More than one definition can be made, providing all symbols are de- 
fined at the beginning of the line. For example. 



LABI: LAB2: LAB3: ) 



Equivalence 

Another means of defining a symbolic name to a numeric value is by equivalence. 
An equivalence line associates a value to a symbol, and that symbol can then 
be used any time the value is required. The syntax of an equivalence line is: 



< usr sym> = < exp > i < stmt > 
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Equivalence (Continued) 

Note that a statement can be used to determine the symbol's value. This is 
the simplest example of a statement being used without generating a storage 
word. 

Some equivalence lines are: 



A= 3+5*(4-l) 

B= 10. 

C= ADD# 0, 1,SKP 



Storage words can be assembled using a most common syntax: 



or 



< exp> ) 

< stmt> ) 



These forms account for the majority of assembly source lines. For example, 
if the current location counter has a value of zero NREL (00000'), the state- 
ments below generate words at locations 00000' through 00006 ' . 



B = 



1 



^^< 


> (17-10)/2 


MOV 


0,1 


NIOS 


PTR 


JMP 


A 


6+10. 




B 




A 





Two number types discussed earlier, double precision integer and floating 
point, produce 32-bit values. These numbers can never be combined in exp- 
ressions. They are used to assemble a double storage word. If a label is 
used to start the line, it is assigned the value of the first word's address. 
For example, at location 100 the following are assembled: 

100. D 
100.0 

A: 1E2 

Two words are produced by each line and A is assigned the value 100 absolute. 
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CHAPTER 4 



PERMANENT SYMBOLS 



The permanent symbols are grouped into logical categories. The format for 
describino' riermanent symbols is as follows: 

1. Permanent symbols that are pseudo-ops are listed as such and their 
syntax and purpose are given. 

2. Permanent symbols that may be either a pseudo-op or a value arc 
listed as pseudo-ops and their syntax, purpose, and their value as a 
symbol are given. 

3. Permanent symbols that are not pseudo-ops are listed as sjnnbols and 
their value is given. 



TITLE PSEUDO-OP 



Pseudo-op: 

Syntax: 

Function: 



TITL 



Default: 
Example : 



> 



.TITLA<usr_sym: 



This pseudo-op names a program. The title given is printed 
at the top of every listing page. In addition, it is used to 
identify the relocatable binary output to the loader, library 
file editor, and the debugger. The <usr_sym> need not be 
unique from other symbols defined by the program. 

.MAIN 



• TITL SYB 
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NUMBER RADIX PSEUDO-OPS AND VALUES 



Pseudo-op 
or Symbol: 

Syntax: 

Purpose: 



Value: 
Default: 

Examples: 



.RDX 

.RDXA<exp> 

This pseudo-op defines the radix to be used for numeric input 
conversion by the assembler. <exp> is evaluated in decimal 
and the range of <exp> is: 

2 < exp < 20 

The numeric value of . RDX is the current input radix. 

The default input radix is 8. 





000010 


.RDX 8 


00000 


000123 


123 




000012 


.RDX 10 


00001 


000173 


123 




000020 


.RDX 16 


00002 


000443 


123 


00003 


000020 


(.RDX) 



Note: 



i CURRENT VALUE OF INPUT RADIX 



Input and output radices are entirely distinct. Setting the input 
radix has no effect upon the listing radix. 
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Pseudo-op 
or Symbol: 

Syntax: 

Purpose: 



.RDXO 



> 



Value: 

Default: 

Examples- 



.RDXOA<exp 

This pseudo-op defines the radix to be used for numeric 
conversion of the listing output fields. The <texp> is 
evaluated in decimal and the range of < exp> is 

8 <. <exp> <. 20 

The numeric value of . RDXO is the current output radix. 

The default output radix is 8. 



000012 


.HDX 10 


input radix 10 


00010 


.RDXO 10 


output radix 10 


00077 


77 


^ 


00022 


22 


> decimal listing 


00045 


45 


J 


00003 


.RDX 8 


input radix 8 


000010 


.RDXO S 


output radix 8 


000077 


77 


^ 


000022 


22 


> octal listing 


000045 


45 


J 


000020 


.RDX 16 


input radix 16 


0010 


. RDXO 1 6 


output radix 16 


0077 


77 


^ 


aiTtOO 


OO 


) hexadecimal listing 


irj £j c. O 


c-c- 


0045 


45 


J 


000010 


.RDXO 8 


output radix 8 (input radix 16) 


000167 


77 


"^ 


000042 


22 


> octal listing 


000105 


45 


J 


00010 


. RDXO 1 


output radix 10 (input radix 16) 


00119 


77 


S 


00034 


22 


) decimal listing 


00069 


45 


J 


00010 


. RDX 1 


input radix 10 


0010 


. RDXO 1 6 


output radix 16 


004D 


77 




0016 
002D 


22 
45 


hexadecimal listing 


000010 


(.RDXO) 


current value of output radix ( 



Note: 



Input and output radices are entirely distinct. Setting the output 
radix has no effect on the input radix. 
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SYMBOL TABLE PSEUDO-OPS 



The symbol table pseudo-ops are of the form: 



'pseudo-op> A<usr_sym>= <stmt 



> 



where: <pseudo-op> is one of the following: 

,DALC 

.DIAC 

.DIO 

.DIOA 

.DMR 

.DMRA 

,DUSR 



<usr sym> is a programmer chosen sjrmbol 

<stmt > is a statement (based on previously defined semi'permanent 
symbols) or expression 

The symbol table pseudo-ops define a user symbol <usr_sym> as a semi -permanent 
symbol <semi_sym> that has as its value the value of the statement or expression 
following the equals sign. 

Each symbol table pseudo-op, except .DUSR, implies a certain type of instruction. 
Thus, once defined, the semi -permanent symbol must be used with expressions 
appropriate to the format required. For example, the pseudo-op .DALC defines 
a symbol that is an implied arithmetic and logical mnemonic and which requires 
expressions following the symbol that are entered into those bit fields that would 
represent in an ALC the source and destination accumulators and the optional skip 
field. The format for .DALC definition of a symbol and the format of the symbol as 
it would later be used are: 



.DALCA<usr sym>=<stmt> 



<usr_sym>A<expj>A<exp2>A ■£<exp3>3- 



where: 



<expi> , < exp2 > , and < exp3> are stored as: 

111111 
123456789012345 



<exp3> 
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For example: 



103120 .DALC MULT4=103I20 



MULT4 is defined |l00001100101000o| 



MULT 4 must be used with two expressions that 
evaluate within the limits of the ALC instruction 
accumulator fields (2 bits for each) 

llOl-QlllOOlOlOOOoi 



If the field to which an expression is to be added cannot accommodate the value of 
the expression an overflow error will occur. The field will be unaltered. 



103120 .DALC MULT4=103120 
000000 107120 MULT4 4,1 



If the field to which an expression is to be added is not zero, the expression to be 
added must evaluate to zero. Otherwise, an overflow error will occur. 



123120 .DALC MULT4=123120 ;BITS 1-2 NOT ZEROED 
000001 127120 MULT4 Ul ; OVERFLOW ON <EXP1> 



00002 123120 MULT4 0,0 



; ACCEPTABLE SINCE 
;<EXP1>=0 



If the expressions following a semi -permanent symbol do not fit the implied format 
a formatting error will result. 



103120 .DALC MULT4=103120 ;TWO, OPTIONALLY THREE, 

J EXPRESSIONS REQUIRED FOR 



F 123120 MULT4 1 

00001 127 121 MULT4. 1,1,1 
F00002 127 121 MULT4 1,1,1,1 



(MULT4. 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



A symbol defined as semi-permanent by a symbol table pseudo-op must, in summary, 
meet the following conditions : 

1. As many expressions must follow the semi-permanent symbol as are 
required by the implied format. Some formats permit optional expressions 
as well as required expressions. 

2. If the number of expressions following the semi-permanent symbol do 
not meet the requirements of the implied format, a format error (F) 
will result. 

3. If an expression does not meet the requirements of the field, i. e. , if 

<exp> .GT. (2field-width _i) 

the field is unaltered and an overflow (O) error results. 

4. If the field in which the expression is to be stored ¥ 0, the expression 
must = 0. Otherwise, an overflow (O) error results, and the field is 
unaltered. 

A given<usr sym> defined in one symbol table pseudo-op may be redefined in another 
symbol table ^seudo -op. The last definition will be the one assigned to<usr_sym > . 

The implied format required by each symbol table pseudo-op is given as part of the 
pseudo-op summary descriptions following. 
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SYMBOL TABLE RSEUDQ-QPS (Continued) 
Pseudo-op: .DALC 



Syntax: 
Purpose: 



Examples: 



. DALC A < usr_sym>= < stmt> 

This pseudo-op defines <usr_sym> as a semi-permanent 
symbol having the value of <stmt>. In addition, the use of 
this symbol implies formatting of an ALC instruction. At 
least two fields, and optionally three, are required. These 
fields are assembled as shown below. 

111111 
1234567890 12345 




m 

< exp2> t_ — ^exp3> 

< exp, "■ 

The format in which the semi -permanent symbol is used is: 
<semi_sym>A<expj>A<exp2>{A <exp3>} 



103400 .DALC ADD= 103400 



00000 103400 ADD 0^0 

00001 103402 ADD 0j0,SEC 
0000? 133401 ADD 1^2*SKP 

F 123400 ADD 1 

F 103400 ADD 



Notes: 



The atom # may be specified anywhere as a break character. 
If seen, a 1 is assembled at bit position 12. 

A given < usr_sym > defined in one . DALC pseudo-op may be 
redefined in another . DALC pseudo-op. The last definition will 
be the one assigned to <usr sym > . 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



Notes: 
(Continued) 



If a three character symbol is defined using this pseudo-op, it can 
be used and followed immediately by one or two letters of the 
following format: 



<sym > 



Z 
O 
C 



L 

l- R 1- 

S 



Use of these letters (or letter) will cause bits 8-9, 10-11 
to be set as follows: 



Mnemonic 


Bits 8 - 9 


Bits 10-11 


L 


01 




R 


10 




S 


11 




Z 




01 







10 


C 




11 
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Pseudo-op: 

Syntax: 

Purpose: 



Examples: 



.DIAC 

. DIAC A < usr_sym>=< stmt> 

This pseudo-op defines <usr_sym> as a semi-permanent 
symbol having the value of < stmt>. The use of the symbol 
implies the formatting of an instruction requiring an accumulator. 
One field is thus required. The field is assembled as shown 
below. 

111111 
12 3 4 5 6 7 89 12 3 4 5 



:exp> 



The format in which the semi -permanent sjnmbol is used is: 
< semi_sym>A < exp> 



S30430 .DIAC RPT=000430 



00000 010430 RPT 2 

F0000I 000430 RPT 
F 0004 30 HPT 



"] 



Illegal number of ejcpressicns 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



Pseudo-op: 

Syntax: 

Purpose: 



Examples: 



.DIO 

.DIOA <usr_syni>=<stmt> 

This pseudo-op defines <usr_sym> as a semi-permanent 
symbol having the value of < stmt>. The use of the symbol 
implies the formatting of an I/O instruction without an AC 
field. One field is required; it is assembled as shown below. 

111111 
0123456789012345 



2d 



< 



exp 



> 



The format in which the semi -permanent sjnnbol is used is: 
<semi sym>A<exp> 



053400 .DIO SKIOK=063400 

F 063400 SKION 

3S002 063402 SKIOM 2 
F00003 063402 SKIOM 2,3 



Note- 



If a three character symbol is defined using this pseudo-op, it 
can be used and followed immediately by a single letter S, C, or 
or P. The use of one of these letters causes bits 8-9 of the 
statement word to be set as follows: 



Mnemonic 


Bits 8-9 


S 


01 


C 


liO 


P 


11 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



Pseudo-op: 

Syntax: 

Pumose! 



.DIOA 

.DIOAA <usr_sym>=<stmt> 

symbol having the value of < stmt>. The use of the symbol 
implies the formatting of an I/O instruction with two required 
fields. The fields are assembled as shown below. 

111111 
12 3 456789012345 



fc 



T 



' expj > I .< exp2 > 

The format in which the semi-permanent symbol is used is: 
< semi_sym>A < exp, >A < exp2> 



Example : 



360500 .DIOA DIA, =060500 
.KREL 
00000' 2J7SS 13 DIA 2jTTl 

!3g001'06g645 DIA 0,45 



Note: 



If a three character symbol is defined using this pseudo-op, it can be 
used and followed immediately by a single letter S, C, or P. The use 
of one of these letters causes bits 8-9 of the statement word to be 
set as follows: 



Mnemonic 

S 
C 
P 



Bits 8-9 

01 
10 
11 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



Pseudo-op: 
Syntax: 
Purpose : 



.DMR 

. DMR A < usr_sym>=< stmt> 

This pseudo-op defines <usr_sym>as a semi -permanent 
symbol having the value of < stmt>. In addition, the symbol 
implies the formatting of an MRI instruction with either 
one or two required fields (an address or a displacement 
and index). The fields are assembled as shown below. 

111111 
0123456789012345 




The formats in which the semi-permanent symbol is used are: 

< semi_sym> A < dsp > 

< semi_sym> A < dsp >A < ndx > 

The <dsp > and <ndx > fields are set according to the format used and 
a set of addressing rules as described in Chapter 3. 



Examples: 



000000 .BMH JMP=000000 
.NPEL 

00001 '095400 JSR 0j3 
00002' 303001 JMP §1^2 
00003' 000431 JMP 1j I 



Note: 



The atom @ may be specified anywhere as a break character. 
If seen, a 1 is assembled at bit position 5. 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



Pseudo-op: 

Syntax: 
Purpose: 



Examples: 



.DMRA 

. DMRA A < usr_sym>=< stmt> 

This pseudo-op defines <usr_sym> as a semi-permanent 
symbol having the value of < stmt>. In addition, the symbol 
implies the formatting of an MRI instmction with either two 
or three required fields. The first field specifies an accumu- 
lator. Where there are three fields, the second and third 
fields are a displacement and index respectively. 
Where there are two fields, the second is an implied address. 
The fields are assembled as shown below. 

111111 
0123456789012345 



_< dsp> 





M 


«ggg^S5^ 



t 



_<: ndx > 



-< exp. > 



The formats in which the semi-permanent symbol is used are: 

< semi_sym> A < exp, > A < exp2 > 

< semi_sym>A < exp^ > A < exp2 > A < exp3> 

The < dsp > and <ndx > fields are set according to the format used 






ciAxu a. owe \JJ. CI-UUXCOO. 



U JLLL \^XlctpLCX U. 



020000 .DMHA LDA= 20000 

. HREL 
035400 LDA 3^ 0^3 
030432 LDA 2, . B+ 1 
000004 .B: .ELK 4 



Note: The atom @ may be specified anywhere as a break character. If seen, a 
1 is assembled at bit position 5. 
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SYMBOL TABLE PSEUDO-OPS (Continued) 



Pseudo-op: 

Sjnitfix: 

Purpose: 



Example : 



.DUSR 

. DUSR A <usr_sym>=< stmt> 

This pseudo-op defines <usr sym> as a semi-permanent 
symbol having the value of < stmt>. Unlike other semi- 
permanent symbols, a symbol defined by a . DUSR is 
merely given a value and has no implied formatting. It 
may be used anywhere a single precision operand would 
be used. 



000325 .DUSP. B=25 

000250 .DUSR C=B*10 

. WREL 
00000' 177555 3-C 
00001'006712 B*C+2 
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SYMBOL TABLE PSEUDO-OPS (Continued) 

Pseudo-op: .XPNG 

Syntax: . XPNG 

Purpose: This pseudo-op removes all macro definitions and all symbol 

definitions, except permanent, from the assembler's synibol table. 
. XPNG is used primarily as follows: 

1. The programmer writes a program containing 
. XPNG followed by definitions of any semi- 
permanent symbols. 

2. The program is assembled using the global switch 

S to the MAC command. This causes the assembler 
to terminate after pass 1. 

3. The programmer can then use the assembler containing 
permanent symbols and those semi -permanent symbols 
defined by the programmer in step 2. 

Example: 



.TITi, XP 

.XPNG 
020000 •DMRA LDA=20000 
040000 .DMPA STA=400g0 

.END 



MAC/S XP 

^ The assembler's symbol table now contains LDA and STA. 
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LOCATION COUNTER PSEUDO-OPS AND VALUES 



Pseudo-op: 

Syntax: 

Purpose: 



BLK 



.BLKA <exp> 



This pseudo-op allocates a block of storage. <exp> is 
the number of words to be reserved. The current 
location counter is incremented by < exp > . 



Example: 



.NREL 
00000' 044403 STA l^.F+1 
00 00 1*04 0403 STA 0J.F+2 



00002*000004 .F: .3LK 4 
00006*090000 'Fl: 
00007*000000 'Fa: 
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LOCATION COUNTER PSEUDO-OPS AND VALUES (Continued) 
Pseudo-OD: . LOG 



Syntax: 
Purpose: 

Value: 

Default: 
Example : 



i> 



, LOCA < exp 



This pseudo-op changes the setting of the current location 
counter to the value and relocation property given by <exp>. 

The current location counter value and relocation property, 
uce, iiowever, tue exception given below. 

Absolute zero. 



00000 300000 A: 

00000'000000 NO: 

.?REL 

00000-000000 Z: 

000100 .LOG 100 
00100 000000 A 
U00101 000000 B 
U00102 000000 C 



00001 000000 A 

000001-.LOC Z+1 
00001-000000 A 



Exception: 



If . LOG is. pushed to the assembler variable stack (see VARIABLE 
STACK PSEUDO-OPS AND VALUES) and subsequently used to 
restore the location counter, e.g. , 



.PUSH .LOG 



.LOG .POP 



then the value is ignored and only the relocation property is 
changed. This allows the user to save the current relocation 
mode within a macro and restore it correctly without affecting 
the relative location counter value which may have been altered 
within the macro. 
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LOCATION COUNTER PSEUDO-OPS AND VALUES (Continued) 
Symbol: 

Value : The symbol . has the value and relocation property of the 

current location counter. 

Example: 



.NREL 



00002*000003 3 

000005 '.LOG .+2 
00005'020010 LDA 0,10 
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LOCATION COUNTER 



Pseudo-op: 

Sjmtax: 

Purpose: 



Examples: 



,NREL 



.NREL 



This pseudo-op causes subsequent source statements to be assembled 
usino" normall^' relocatable addresses. If NREL mode is exited 
during assembly, the current . NREL value is maintauied and used 
if NREL mode is entered again. 



G0003 177775 M: -3 

000100 .LOG 100 
00100 000003 M 

.NREL 
00000*000003 .A: M 
00001 '002777 JMP @.A 

000200 .LOG 200 
00200 000003 M 

.NREL 
00002*000003 M 



;note next available NREL address 
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LOCATION COUNTER 



Pseudo-op: 

Syntax: 

Purpose: 



.ZREL 



ZREL 



This pseudo-op causes subsequent source statements to be assem- 
bled using page zero relocatable addresses. If ZREL mode is exited 
during assembly, the current . ZREL value is maintained and is used 
if . ZREL mode is entered again. 



Example : 



00000 000000 AL: 
.ZREL 

00000-000000 Z: 

00001-000000 ZL: 

000100 .LOC 100 

00100 000000 AL 

.ZREL 

00002-000000 AL 
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INTERPROGRAM COMMUNICATION PSEUDO-OPS 

Pseudo-op: .COMM 

Syntax: .COMM A <usr_syin > A <exp > 

Purpose: This pseudo-op is used to reserve an area for interprogram com- 

munication having the name <usr_sym > and the size in words 
as given by < exp >. This area will be reserved by the first routine 
loaded that declared the named <usr sym >. The area is reserved 
at NMAX, immediately preceding any NREL code loaded. Further 
routines loaded declaring the same symbol share this original area, 
provided the sizes specified are the same. 

Since <usr_sym > is an entry in the program, it cannot be redefined 
elsewhere in the program The <usr_sym > may be referenced 
from other programs loaded together using . EXTN, . EXTD, or 
.GADD pseudo-ops. 

Example : 



.TITL A 
000100 .COMM X, 100 
000040 .COMM Y,40 
000050 .COMM 2,50 



.END 

.TITL B 
000100 .COMM X, 100 



END 



Loading would take place as follows: 



high core 



initial NMAX 



B 


A 


50 words 


40 words 


100 words 





A's start of NREL 



Z 

Y 

X 
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INTERPROGRAM COMMUNICATION PSEUDQ-OPS (Continued) 

Pseudo-op: . CSIZ 

Syntax: .CSIZ A <exp> 

Purpose: This pseudo-op specifies the size in words of a program area 
to be used for interprogram communication. 

The assembler evaluates <exp> and passes this value to the 
loader. More than one . CSIZ pseudo-op may appear in a pro- 
gram. At load time, the largest value specified by all .CSIZ 
blocks is used to set USTCS at the termination of the load. 



Example: 



000020 



.TITL A 
.CSIE 20 



END 



.TITL X 
!00050 .CSIZ 50 



END 



RLDR A X 




A 




X 




NMAX 


001037 


ZMAX 


000050 


CSZE 


000050 


EST 




SST 





20 words allocated 



'50 words allocated in communicating 
program to be loaded with A. 



At load time the largest area is selected 
for USTCS (prints as CSZE). 



4-22 



INTERPROGRAM COMMUNICATION PSEUDO-OPS (Continued) 
Pseudo-op: . ENT 



Syntax: 
Purpose: 



.ENT A<usr_symj>E <usr_sym2> *•» ^ <usr_sym^>^ 

This pseudo-op declares each <usr_sym> as a symbol that is 
defined within the program and that may be referenced by 

>^^^fa.^.%^\,\^j.y «Ai:rL7V^i.xu^xwu. ^i\J^A.CLlLlO0 

A <usr_sym> appearing in a . ENT pseudo-op must be defined 
as a user symbol within the program in which it is declared. 
This symbol must be unique from entries defined in othe^programs 
loaded together to form a save file. If not, the loader will issue 
a message indicating multiply defined entries. 

Entries are referenced in separately assembled programs using 
one of the following pseudo-ops: 

.EXTD 
.EXTN 
.GADD 
.GLOC 



Example: 



.TITL A 

sFWT n. n 

•EXTN C 
.?REL 
00000-177777 .C: C 

• NREL 
00000'006000-B: JSR @.C 






END 
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INTERPROGRAM COMMUNICATION PSEUDO-OPS (Continued) 

Pseudo-op: . ENTO 

Syntax: . ENTO A < usr_sym> 

Purpose: This pseudo-op is used when a program is to become an 

overlay within an overlay segment. The pseudo-op causes 
the name <usr sym> to be associated with the node number 
and overlay number assigned to the particular overlay. The 
overlay may then be referenced from another program by 
<usr sym> . <usr_sym> must be declared as an .EXTN 
in the referencing program. 

Caution: <usr_sym> cannot appear elsewhere in the program in 

which is declared as the name of an overlay, since its 
value is assigned at load time. 

Example: 



.TITLE TIME 
.ENTO METER 
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Pseudo-op: . EXTD 



S3mtax: 
Puirpose: 



.EXTDA<usr_symj^>-E< usr_syin2> '" ^ ^^^^ -^^^ >3 

This pseudo-op declares each <usr_sym> as a symbol which 
may be referenced by the program but which is defined in 
some other program. The <usr_sym> must be declared by 
an . ENTpseudo-op iij the program in which it is defined. 

Any symbol declared as an . EXTD may be used as an address 
or displacement of a memory reference instruction. In addi- 
tion, it can be used to specify the contents of a 16 -bit storage word. 

If used as a page zero address or as a displacement, it is 
the programmer's responsibility to insure the value of the 
entry meets the specific requirements, i. e. , 

< page_zero_adr <. 377 

-200 <. displacement <. 200 



Example: 



•TITL E 
.EXTD .CR 
.ZREL 



00000-000001$, CR 
00001-006001$. DONE: JSR @.CR 

.EWD 
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INTERPROGRAM COMMUNICATION PSEUDO-OPS (Continued) 

Pseudo-op: . EXTN 

Syntax: . EXTN A <usr_symj>{< usr_syni2> . . . A < usr_symn-^> 

Purpose: This pseudo-op declares each <usr_sym> as a symbol that is 
externally defined in some other program but may be refer- 
enced by the current program. The <usr_sym> must be 
declared using an . ENT pseudo-op in the program in which it 
is defined. 

A symbol declared as a . EXTN can be used only to specify 

the contents of a 16 -bit storage word. The value at load time is 

therefore a number in the range to 2 -1. 



Example : 



.TITL B 
.EKTN C 
.gREL 
0R1000-177777 .C: C 
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INTERPRQGRAM COMMUNICATION PSEUDO-OPS (Continued) 
Pseudo-op: .EXTU 



Syntax: 
Purpose: 

Example: 



.EXTU 

This pseudo-op causes the assembler to treat all symbols that 
are undefined after pass 1 as if they had appeared in an . EXTD 
Statemenf. 



.TITL A13 
. EXTU 

00000 02400l$LDA l^B 

.END 
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INTERPROGRAM COMMUNICATION PSEUDO-OPS (Continued) 



Pseudo-op: 

Syntax: 

Purpose: 



.GADD 

. GADD & < usr_sym > A < exp > 

This pseudo-op generates a storage word whose contents is re- 
solved at load time. The value of <usr_sym > is searched for 
at load time and, if found, its value plus the value of the < exp > 
are added to form the contents of the storage word. If the 
<usr sym > is not found, a loader error results and the storage 
word"will contain just the value of <exp >. 

The<usr sym > must be a symbol defined in some separately 
assembled program and appearing In that program in an . ENT, 
. ENTO, or . COMM pseudo-op. . GADD may thus be used 
in a similar manner to . EXTN with the following differences: 

A user symJx>l appearing in a , EXTN pseudo-op and used as a 
storage word is resolved regardless of whether the defining 
program is loaded before or after the program containing 
the . EXTN . 

A user symbol appearing in a .GADD block is resolved only 
If the defining program is loaded before the program containing 
the . GADD block. 



Example: 



U00100 





.TITL Y 




.ENT A 


000200 


.LOG 200 




A: 




.EMD 




.TITL X 


003100 


.LOG 100 


00000 7 


.GADD A, 




.END 



Value of A is 200. 



3 + 4 



Value of 7 assigned on assembly. 



When loaded in the order Y - X, the value stored will be 207. 
If X is loaded first, an error message wlU result and the value 
stored will be 7. 
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INTERPRQGRAM COMMUNICATION PSEUDO-OPS (Continued) 
Pseudo-op: . GLOC 



Syntax: 
Purpose: 



. GLOC A <usr_sym > 

This pseudo-op begins a block of absolute data orlgined at the value 
of <usr_sym > at load time. The block is terminated by the next 
occurrence of a . LOG, . NREL, . ZREL, or . END pseudo-op. 

The <usr_sym > must be defined by an . ENT or . COMM in a 
program loaded prior to the global location block or a fatal load 
error will result. 

Within the block, there can be no external references, no label 
definitions and no label references. 



Example : 



.TITL 
000003 .COMM 



END 



A 
MYAREA* 3 





.TITL 


B 




.GLOC 


MY AREA 


00000'000001 


i 




00001 '000002 


2 




00002*000003 


3 

.NREL 





Program B, loaded after program A will 
initialize program. A's named common area. 



■ END 
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TEXT PSEUDO-OP AND VALUES 



Pseudo-op: 


.TXT 




.TXTE 




.TXTF 




.TXTO 


Syntax: 


. TXT A a < string > a 




. TXTE Aa < string > a 




.TX'l'FAof < string > a 




. TXTO A CK < string > a 



Purpose: 



These pseudo-ops cause the assennbler to scan the input following 
the character a up to the next occurrence of the character a 
in string mode. The character a may be any character not used 
within the string except null, line feed, or rubout. a delimits but is 
not part of the string. Carriage return and form feed may be used 
to continue the string from line to line or page to page, but are 
not stored as part of the text string. 

Every two bytes generate a single storage word containing the 
ASCII codes for the bytes. Storage of a character of a string 
requires seven bits of an eight -bit byte. The leftmost (parity) 
bit may be set to 0, 1, even parity, or odd parity as follows: 



TXT 
.TXTF 
,TKTE 
,TXTO 



Sets leftmost bit to unconditionally. 
Sets leftmost bit to 1 unconditionally. 
Sets leftmost bit for even parity on byte. 
Sets leftmost bit for odd parity on byte. 



The packing mode can be altered using the , TXTM pseudo-op. 
If an even number of bytes are assembled, the null word following 
these packed bytes can be suppressed by the .TXTN pseudo-op. 
See pages 4-33 and 4-32. 

Within the string, angle brackets can be used to delimit an arith- 
metic expression. The expression will be evaluated, masked to 
seven bits, and the eighth bit set as specified by the pseudo-op. 
Note that no logical operators are permitted within the expression. 
This is the only means, for example, to store a carriage return as 
part of the text string. 

.TXT "LINE 1<15 >" J 
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TEXT PSEUDO-OPS AND VALUES (Continued) 

Default: Bytes are packed right/left, and a null byte is generated as the 

terminating byte. 

Example: 



00000 041101 ,TXT #AB CD# 
041440 

000104 

00003 041101 .TXTE #AB CD# 
141640 
000104 

00006 141301 .TXTF #AB CD# 
141640 

000304 

00011 141301 .TXTQ #AB CD;? 
041440 
000304 
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TEXT PSEUDO-OPS AND VALUES (Continued) 



Pseudo-op 
or Symbol: 

Syntax: 

Purpose: 



Value: 



Default: 



Example: 



.TXTM 



.TXTMA <exp> 

This pseudo-op changes the packing of bytes generated using the 
text pseudo -ops, .TXT, .TXTE, .TXTF, or . TXTO . If <exp> 
evaluates to zero, bytes are packed right/left; if < exp > does not 
evaluate to zero, bytes are packed left/rig^t. 

The value of . TXTM is the value of the lagt expression used 
within the . TXTM pseudo -op. 

Bytes are packed right/left. 



000000 .TXTM 
00000 041101 .TXT #AB CD# 

041440 
000104 

00003 000000 C.TXTM) 

000001 .TXTM 1 

00004 040502 .TXT #AB CD# 
020103 

042000 
00007 000001 



(.TXTM) 
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TEXT PSEUDO-OPS AND VALUES (Continued) 
.TXTN 



Pseudo-op 
or Symbol: 

Syntax: 

Purpose: 



Value : 



Defeult: 



Example : 



.TXTN A <exp > 

This pseudo-op determines whether or not a string that contains 
an even number of characters will terminate with a word con- 
sisting of two zero bytes. (When the nuntiber of characters in the 
string is odd, the last word contains a zero byte in all cases. ) 

If < exp ^ evaluates to zero, all text strings containing an even 
number of bytes will terminate with a full word zero. If < exp > does 
not evaluate to zero, any text string containing an even number of 
bytes terminates with a word containing the last two characters 
of the string. 

The value of . TXTN is the value of the last expression used 
within the . TXTN pseudo-op. 

The string terminates with a zero word. 





000000 


.TXTN 


00000 


031061 
032063 
000000 


.TXT /1234/ 


00003 


000000 


(.TXTN) 




000001 


.TXTN 1 


00004 


031061 
032063 


.TXT /1234/ 


00006 


000001 


+.TXTN 
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FILE TERMINATING PSEUDO-OPS 



Pseudo-op: 

Syntax: 

PuiTX)se: 



Example : 



END 



. END f A < exp > 3 

This pseudo-op terminates a source program, providing an end 
of program indicator for the loader. The < exp > is an optional 
argument specifying a starting address for execution. The loader 
initializes TCBPC of the active TCB to the last address, if any, 
specified by a relocatable binary at load time. Execution of the 
loaded save file begins at this address. (If the loader finds no 
starting address among programs loaded, an error message is given. ) 



.TITL GETCT 
102400 GETCT: SUB 0,0 ; INITIATE FOR STARTUP 
.END GETCT 
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FILE TERMINATING PSEUDQ-QPS (Continued) 
Pseudo-op: . EOT 

Syntax: . EOT 



Purpose: 



E xample: 



This pseudo-op is used to indicate the end of an input file but not 
the end of input source. End of file from an input file is an 
implicit . EOT if other source files follow; end of file from the last 






.TITL PGM 



.EOT 
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REPETITION AND CONDITIONAL PSEUDO-OPS 



Pseudo-op: 

Syntax: 

Purpose: 

Examples: 



• DO 



.DOA <e3q)> 



This pseudo-op causes the source program lines between the . DO 
and the corresponding . ENDC to be assembled the number of times 
given by < exp > . 





000000 


1=0 N 






000004 


.DO 4 




00000 


100000 


IBI 






000001 


1 = 1 + 1 
.ENDC 




00001 


040000 


IB! 






000002 


1 = 1 + 1 








.ENDC 


) , 


00002 


020000 


IBI 


i 




000003 


1 = 1 + 1 

.ENDC 




00003 


010000 


IBI 






000004 


1 = 1 + 1 
.ENDC 






000003 


A = 3 






000000 


.DO 4== 

5 

2 

.ENDC 


A 




000001 


.DO 4== 


(A+1 ) 


00004 


000005 


5 




00005 


000002 


2 
.ENDC 





Source Program 



Listing 



1=0 
.DO 4 
IBI 
1 = 1 + 1 
.ENDC 



- loop is assembled 
4 times 



Relational expression evaluates to (false). 



<- Relational expression evaluates to 1 (true), 
so loop is assembled once. 



Note: The . DO's may be nested to any depth, the innermost . DO corresponding to 
the innermost . ENDC, etc. 
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REPETITION AND CONDITIONAL PSEUDO-OPS (Continued) 



Pseudo-op: 



.IFE 

.IFL 
.IFN 



Syntax: 



Purpose: 



. IFEA <exp > 
. IFGA <ejq) > 
.IFLA<exp> 
.IFNA <exp> 

These pseudo-ops cause the statements following to be assembled 
if the condition defined in the pseudo-op is met. The pseudo-ops 
define the followiug conditions: 



.IFEA<exp> 
.IFGA<exp> 
.IFL^ <exp> 
. IFNA <e3q) > 



Assemble if <exp> equals 0. 
Assemble if <exp > is greater than 0, 
Assemble if <exp> is less than 0. 
Assemble if < exp > is not equal to 0. 



The value field of the listing is 1 If the condition is true and if 
the condition is false. 



Example: 



000000 


A=0 




000000 


B=A 
.NREL 




000000 


.IFE B-2 
LDA 0*A 
.ENDC 


^ 


000000 


.IFG B-2 
LDA 0^A 
.ENDC 


y 


000001 


.IFL B-2 


N 


00000'020000 


LDA 0jA 
.ENDC 




000001 


.IFN B-2 




00001 '020000 


LDA 0,A 
.ENDC 


y 



iThe expression evaluates to false in these cases, so 
' the load instruction is not assembled. 



The expression evaluates to true in these cases, so 
the load instruction is assembled. 



Note: The .IP's may be nested to any depth, the innermost . IF corresponding to the 
innermost . ENDC, etc. Note that all . IF conditions are degenerate forms of 
.DO's. For example: 

. IFG A is equivalent to . DO A > 
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REPETITION AND CONDITIONAL PSEUDO-OPS (Continued) 



Pseudo-op: 

Syntax: 

Purpose: 



Example: 



.ENDC 



.ENDC 



This pseudo-op terminates statements for repetitive assembly 
(statements following a . EXD pseudo-op) or statements whose 
assembly is conditional (statements following one of the pseudo- 
ops: .IFE, .IFG, .IFL, .IFN). 



1 = 1 


.DO 5 


1*1 


1 = 1 + 1 


.ENDC 
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MACRO PSEUDO-OPS AND VALUES 



Pseudo-qp: 

Syntax: 

Purpose: 



Example: 



.MACRO 

.MACROA<usr_sym> ^ 

This pseudo-op defines <usr_sym> as the name of the macro 
definition that follows. Any line or lines that follow are part 
of the macro definition up to the first % character encountered. 

Once defined, < usr _sym > can be used to call the macro. 







.MACRO TEST 






tl 








t2 








t3 








% 








TEST 


4,5,6 


00000 


000004 


4 




00001 


000005 


5 




00002 


000006 


6 






000020 


.RDX 


16 






TEST 


0A,0B,0C 


00003 


000012 


0A 




00004 


000013 


0B 




00005 


000014 


0C 





;<USR-SYM> IS TEST 
,' MACRO DEFINITION 

; MACRO CALL WITH ARCS 4,5,6 



;MACR0 CALL WITH ARCS 0A,0B,0C 
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MACRO PSEUDO-OPS AND VALUES (Continued) 
. ARGCT 



Symbol: 



Value: 



. ARGCT has as a value the nunaber of actual arguments specified 
by the most recent macro call. If the symbol is used outside a 
macro, its value is -1. 



Example: 



000-00 
00001 



.NREL 
.MACRO X 
tl+t2 
.ARGCT 
% 

X 4,5 

'000011 4+5 
000002 .ARGCT 



;CALL HAS TWO ARCS 
JVALUE OF .ARGCT IS TWO 



4-40 



MACRO PSEUDO-OPS AND VALUES (Continued) 

Symbol: , MCALL 

Value: . MCALL has value 1 if the macro in which it appears has been called 

previously on this assembly pass, and value if this is the first 
call on this pass. If used outside a macro, its value is -1. 

Example: 



.MACRO X 

.DO .MCALL 

u>jR e . ^\ J fj tjii iF invjT FiRjT uALx,* 

.ENDC 

.DO .MCALL ==0 ;IF FIRST CALL , GENERATE SUBROUTINE 

.PUSH .LOC ;SAVE LOCATION COUNTER 

• ZREL 

.X: X ;POINTER TO SUBROUTINE 

.LOC .POP ;restore location counter 

JSR X ; CALL X 

JMP xend ; JUMP past X 

X; 



J code for X 

JMP 0>3 J RETURN 

XEND: 

.ENDC 
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LISTE^G PSEUDO -OPS AND VALUES 



Pseudo-op: 

Syntax: 

Purpose: 



Value: 

Default: 
Examples: 



. NOCON 

.NOCONA<e}q)> 

This pseudo-op either inhibits or permits listing of those condition- 
al portions of the source program that do not meet the conditions 
given for assembly. If the value of <exp> / 0, listing is inhib- 
ited; if the value of <exp> = 0, listing is permitted. 

Conditional portions of the source program that would be assembled 
are not affected by the . NOCDN pseudo-op. 

The value of. NOCON is the value of the last expression used 
within the . NOCON pseudo-op. 

Listing is permitted. 















.NOCON 












.DO 4==A 












5 
3 






000003 


A = 3 


\ 


.ENDC 






000000 


.NOCON 




.DO 4 = = CA+n 






000000 


.DO 4==A 

5 

3 

• ENDC 




5 
3 

• ENDC 


\ Source 
Program 








.NOCON 1 
.DO 4==A 
5 

3 


00000 
00001 


00000! 
000005 
000003 


.DO 4==<A+1 ) 

5 

3 










.ENDC 




.ENDC 






000001 


.NOCON 1 




.DO 4==CA+1 ) 
5 

3 
.ENDC 




00002 


000001 
000005 


.DO 4==CA+1) 
5 






00033 


000003 


3 

.ENOC 


/ 



I Listing 
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Pseudo-op: 

Syntax: 

Purpose: 



Value: 



.NOLOC 

.NOLOC A<exp> 

This pseudo-op is used to inhibit listing of lines which do not 
include a location field. If the value of <exp > is not equal to zero, 
listing is inhibited; if the value of <exp > is equal to 0, listing 
occurs. 

The value of . NOLOC is the value of the last expression used 
within the . NOLOC pseudo-op. 



Default: 



Listing is permitted. 



4-43 



LISTING PSEUDO-OPS AND VALUES (continued) 



Pseudo-op: 

Syntax: 

Purpose: 

Value: 

Default: 
Exa mples: 



.NOMAC 

.N0MACA<e3q)> 

This pseudo-op is used to inhibit the listing of macro expansions. 
If <exp> evaluates to zero, macro ejqiansions will be listed; 
otherwise, macro ejqjansions are inhibited. 

The value of . NOMAC is the value of the last expression used 
within the . NOMAC pseudo-op. 

Expansions are listed. 



.MACRO OR 

COM tl,tl 
AND tl,t2 
ADC tl,t2 



000001 .NOMAC 1 
OR CI, 23 

000000 .NOMAC 



^EXPANSION INHIBITED 



;EXPANSION PERMITTED 



00003 
00004 
00005 


174000 
163400 
162000 


OR C3,03 • 
COM 3,3 
AND 3,0 
ADC 3,0 

.MACRO TEST 

5 

6 

.NOMAC 1 

7 

8 

% 






00000 
00001 


000005 
000006 


TEST 
5 

6 



;MACR0 EXPANSION MAY BE INHIBITED OR PERMITTED 
;AT ANY TIME WITHIN THE MACRO 



.END 



Note: 



. NOMAC can be used within a macro definition to selectively inhibit listing. 
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VARIABLE STACK PSEUDO-OPS AND VALUES 



Pseudo-op: 

Syntax: 

Pui^jose: 



Example: 



.PUSH 

. PUSHA < exp > 

This pseudo-op allows the programmer to save the value and relo- 
cation properties of any legal assembler ejqpression on an internal 
assembler stack. Additional expressions may be pushed until the 
stack space is exhausted. Tne stack is referenced by the perma- 
nent symbols . POP and . TOP. As with any push down stack, the 
last e3q)ression "pushed" is the first expression to be "popped. " 

The current value of the input radix may be saved, its value altered 
and then restored by the following statements. 



000010 .PUSH .RDX 
000012 .RDX 10 



000010 .RDX .POP 
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VARIABLE STACK PSEUDO-OPS AND VALUES (Continued) 



Symbol: 
Value: 

Default: 
Example: 



.POP 

The value of . POP is the value and relocation property of the last 
value pushed on the variable stack (. PUSH pseudo-cp). In addition, 
use of . POP causes the value and relocation property to be popped. 

If there are no values on the variable stack, . POP has a value of 
absolute zero and a zero flag will be given the line in which it is used. 



000025 A=25 
000025 A 

000025 .PUSH A 
000015 A=15 
000015 A 

000025 A=.POP 
000025 A 

.END 
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VARIABLE STACK PSEUDO-OPS AND VALUES (Continued) 
Symbol: .TOP 



Value: 



Examnle: 



The value of .TOP is the value and relocation property of the last 
value pushed to the variable stack. . TOP differs from . POP in 
that use of the symbol does not pop the last pushed value from the 
stack. If no values are pushed, absolute is returned and the 
flag is given. 



000020 .PUSH 20 

00000 000020 .TOP 

00001 000020 .TOP 
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PASS VALUE 

Symbol: 

Value: 

Example: 



,PASS 



. PASS has a value of zero on pass 1 and a value of one on pass 
2 of assembly. 





000020 


.RDX 16 


00000 


000000 


C: 


00001 


000021 


D: 08+9 


00002 


032001 


LDA 2,§D 


00003 


000001 


.PASS 

• 



;Value on listing pass (pass 2) is 
; always 1. 
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CHAPTER 5 
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THE MACRO FACILITY 

The macro facility allows a string of source characters, perhaps consisting of many 
lines, to be named and subsequently referenced by name. In addition, the definition 
string may specify formal arguments within the string that are replaced by actual arg - 
uments whenever the macro is expanded. The macro is defined only once within a pro- 
gram but may be referenced ( called ) any number of times after the definition. 

The macro definition associates a user symbol with the definition. Then whenever the 
macro symbol is encountered in assembly of the source program, the definition is sub- 
stituted for the symbol. The substitution is called macro expansion , and the encounter 
of the symbol is a macro call. 

Macro Definition 

The programmer writes a macro definition once. The macro definition can then be sub- 
stituted in his program anywhere the appropriate macro name is encountered during assembly. 
A macro definition has the form: 



. MACRO A < usr_sym > ^ 
<macro_definition_string> % 



y/here: <usr_sym.> is the name to be used in the macro call to identify the macro 
that is to be expanded into the program at that point. 

<macro_definition_string> is a string of ASCII characters to be substituted 
for the macro call. 

% terminates <macro definition string > and is not part of the definition. 

Within <macro_definition_string> two characters ( *- and t ) have special meanings. 
The back arrow ( *- ) is ignored but causes the character immediately following to be 
stored without any interpretation. It would be used, for example, if the user wishes a 
percent sign (%) to be part of the macro definition string. (Normally, the % terminates 
the macro definition. ) If the user wants to write a <macro_definition_string> that will 
be 

ABC%D 

he would write <macro_definition_string> as: 
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Macro Definition (Continued) 

ABC*- %D 
Similarly, if the user wishes to write a <macro_deftnition_string> that will be 

X — YZ 
he would write the <macro_definition_string> as: 

X — - YZ 

The back arrow convention can be used for any ASCII character. For example, if the 
user writes either 

X or *-X 

the character will be read as X in either case. However, the back arrow convention is 
most often used for characters that will otherwise be interpreted, such as %, t , and 
— itself. 

The second character having a special meaning is the up arrow ( t ). An up arrow is 
followed by an alphanumeric character representing a formal argument interpreted as 
follows: 

tn where n is 1-9 

I a whereaisA-Z 

A digit following t represents the positional value of an actual argument in 
the argument list of the macro call that will replace the formal argument tn 
wherever it appears within the macro definition. For example, if the formal 
argument 1 3 occurs in the <macro_definitionjstring> , then it will be re- 
placed by the third argument in the macro call as described in the next sec- 
tion. (A zero following t is unconditionally replaced by the null string. ) 

A letter following t is a symbol whose value is looked up when macro expan- 
sion occurs. The value of the symbol is used as the positional value of the 
actual argument to the macro call that is to replace t a wherever it appears 
within the macro definition. 

The carriage return following <user_sym > is required to distinguish <user_sym > 
from the macro definition string. Except for the characters previously noted ( ^ , I , 
% ), all characters in the <macro_definition_string> are returned during macro ex- 
pansion exactly as written. For example, if the definition consists of a string that is 
to be expanded into several lines of source language, each line must be terminated by 
a carriage return. 
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If the definition consists of a single expression that is to he substituted as, for example, 
v^^w L^w»,v,ixv* v^i^ioaxu wj. a Liixcc-u^jciaiiu juiisiruction, uie macro aeimition string 
cannot contain carriage returns, comments, etc. To define an expression within a 
macro definition string, the expression must fall within the Hne limitations of the 
assembler (132 characters maximum). 

The % terminating the macro definition string wiU appear in the macro definition as the 
first character of the last line of the macro definition if the macro definition is one or 
more complete lines of assembly source program. If the definition is not a complete 
i±iic , Liie 7o will appear immediately following the string that constitutes the definition. 

The user symbol that names the macro must follow assembler rules for user symbols. 
Examples of macro definitions are: 



. MACRO t:> 

LDA 0,0,3^ 
MOV 0,0. SNR^ 



.MACRO EXP) 
TESTtl+t2% 

. MACRO COM>^ 

;TEST FOR 95 ♦• % DONE ) 

% 



The definition of a macro may be temporarily terminated and then continued. This is 
especially useful if a first macro is used to define a second macro. The first macro 
may terminate definition of the inner macro temporarily, assign new equivalences, and 
continue. The macro VFD given later illustrates this continuation property. 

Syntactically, if a macro of the same name as the last defined macro is encountered, 
the second and subsequent "definitions" are appended, in order, to the first definition. 
For example. 



.MACRO TEST I 

.MACRO TEST> 
J=0 ) 

is equivalent to: 

.MACRO TEST> 
1 = \ 
J=0 \ 

% 
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Macro Calls 



For a given macro definition, any number of macro calls of that definition may appear 
in the source program. A macro instruction consists of the user symbol given in a 
macro definition followed by any actual arguments to replace formal arguments in the 
macro definition string. 

A macro call has one of the following forms: 



(1) <mac_sym > A 

(2) <mac_sym >A <stringj > t < sp xstring^ ><sp > . . . <string^>-}- ^ 

(3) ^mac_sym> f Ah [ <string^>f <sp><string2><sp>. .. <string^>}- ] ^ 



where: <mac_sym> is the name of some macro definition. 

Each <string. > is an actual argument that is to be substituted for 
the appropriate formal argument during macro ejqjansion. 

The first form of the macro instruction presumes that there are no formal arguments 
within the macro definition. Forms two and three presume timt one or more formal 
arguments must be replaced by actual arguments. 

Substitution of actual arguments is accomplished by using <rstringj>to replace every 
occurrence of tl (or to replace fa where a evaluates to 1), <string >to replace every 
occurrence of 1 2, etc. If no formal arguments were specified in tne definition, no 
arguments can be specified by the call. If more arguments are given by the call than 
specified by the definition, they are ignored. 

The list of arguments of a macro call may either be enclosed in square brackets (form 
3) or not enclosed in square brackets (form 2). The difference is that form 2 terminates 
with a carriage return before the first byte of the macro e3q)ansion, whereas form 3 
does not. If a macro is to replace the index field of an instruction, form 3 should be 
used. In general, form 2 type calls are more common. For example: 



Macro Definition 

.MACRO D ^ 
TEMPa% 



Alternative Instructions and their E3q)ansions 



STA 3, D[ 2] 
STA 3, TEMP2 



-^ macro call 



■^ after expansion 



D 2 ^ 

+3 

TEMP2+3 



-^ macro call 

*- after expansion 
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Macro Calls (Continued) 

Argument strings, like text strings, may consist of any characters. Argument strings 
are separated by a single break character <sp> . The effect is that leading commas, 
spaces or tabulations may be part of the argument. * The argument string is terminated 
by the first <rsp > encountered. 

Listing of Macro Expansions 

The maimer of substituting a macro definition for a macro instruction follows the pro- 
cedures just described. However, the listing output showing the expanded source text 
is not the same as the macro expansion used to generate the object fUe output. The 
listing will show both the macro call and the macro expansion, while the object fUe will 
contain only the object code equivalents of the macro expansion with the appropriate 
actual arguments. An example is: 



.MACRO 


DSP^ 


LDA 


0,DSP [121], 3 


LDA 


0, 121, 3 


LDA 


0, DSP [121] 121, 3 



— macro definition 



-^source listing line with macro 

■^ e3q)anded line to be translated to 

object file 
^expanded line as it appears in the 

listing file 



The listing of macro expansions may be suppressed using the pseudo-op . NOMAC. K 
suppressed, the load instruction above would appear on the listing exacdy as it appears 
in the source listing line. 



.MACl.O .-: 

5 

LDA tl,ts 

% 

■6 kit A 
Qiii:}(oiu vi 00005 5 
00001 iJ2vi(3iOA LDA 0tA 

00U{:Jyl •OJOi'iAC 1 
6 ^A,A 

003000 .NOi'iAC 

00004 00000 5 5 

0000 5 02000 4 L0A 0*4 
• £i\'0 



Macro expansions are listed by default. 

An expression evaluating to a value other than 
zero following . NOMAC causes suppression of 
listing of macro expansions. 

An expression expansion evaluating to zero 
following . NOMAC restores the listing of 
macro expansions. 



This applies to all argument strings except for the first argument string of an 
argument list that is not enclosed by square brackets. 
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Macro Examples 

A number of macro examples follow. Note that use of the recursive property of the 
macro, FACT, and the use of macro continuation and the special character *- within 
VFD. 

The first example is a macro to compute the logical OR of two accumulators. Its call 
takes a form similar to an ALC instruction, i. e. , 

OR A <src><sp><des> 

The source accumulator is unchanged by the call. Note also that actual arguments re- 
place formal arguments within the comments. 

Definition 



J LOGICAL OR MACRO 

} CALL : 

OR <OP-0>*<OP-1> 

S WHERE THE RESULT IS: 

; <OP-0> .OR. <0P-1> 



.MACRO OR 

COM T 1 , t 1 

AND tl,t2 

ADC .tl,t2 



i CLEAR "OM" BITS OF ACtl 
; OR RESULT TO ACt2 



.NREL 



Calls 





OR 


1>2 


00000 '124000 


COM 


Is 1 


00001 M33400 


AND 


1^2 


00002* 132000 


ADC 


1,2 




OR 


0, 1 


00003M00000 


COM 


0*0 


00004' 107400 


AND 


0>1 


00005' 106000 


ADC 


0, 1 



CLEAR "ON" BITS OF 
OR RESULT TO AC2 



ACl 



CLEAR "ON' 
OR RESULT 



■ BITS OF AC0 
TO ACl 
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Macro Examples (Continued) 

A somewhat more illustrative example is that of logical exclusive OR. This macro 
allows an optional third argument. If absent. ACS is used as a temporary accumu- 
lator and is destroyed. If the third argument is given, it is used as a temporary 
storage location for saving and restoring AC3. The absence of an argument is con- 
veniently tested for by making a comparison with the null string, e.g., 



.DO 't3'== 



f n 



In addition, this macro saves the state of the no conditionals list option, turns them 
off, and restores the original state upon exit. Further, since a number of the listing 
control and variable stack munipulation pseudo-ops print, they have been suppressed 
using the ** atom. This enables a "clean" listing output. 
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Macro Examples (Continued) 

i EXCLUSIVE OR 
i CALL : 



XOR 



<SRC>><DES>C*<TMP>3 



IF NO <TMP>, AC3 IS USED AS THE TEMPORARY AC 
IF <TMP>* MEM LOG <TMP> IS USED TO 
SAVE AND RESTORE AC3 





.MACRO 


XOR 


** 


.PUSH 


. NO DON 


** 


.NO CON 


1 


** 


.DO 


•t3'<> • • 




STA 


3*»3 


** 


.EN DC 






MOV- 


t2,3 




ANDHL 


tl,3 




ADD 


t l,t2 




SUB 


3*t2 


** 


.DO 


•t3'<> • • 




LDA 


3,t3 


** 


.ENDC 




** 


.NO DON 


.POP 



i SAVE AC3 IN t3 



; 2*(ACtl .AND. ACt2) 

i ACtl + ACt2 

; ACtl .XOR. ACt2 

i RESTORE AC3 FROM t3 



00000-000001 TEMP! 



.ZREL 
.BLK 

.NREL 



00000' 155000 
00001 M375S0 
00002' 133000 
00003' 172400 



00004'054000- 
00005*135000 
00006*117520 
00007' 107000 
00010* 166400 
0001 1 *034000- 



XOR 


1>2 


MOV 


2#3 


AN DEL 


1,3 


ADD 


1,2 


SUB 


3,2 


XOR 


0,1, TEMP 


STA 


3, TEMP 


MOV 


1,3 


ANDZL 


0,3 


ADD 


0, 1 


SUB 


3,1 


LDA 


3, TEMP 



; 2*(AC1 .AND. AC2) 

; ACl + AC2 

} ACl .XOR. AC2 



; SAVE AC3 IN TEMP 

J 2*(AC0 .AND. ACl) 

; AC0 + ACl 

; AC0 .XOR. ACl 

} RESTORE AC3 FROM TEMP 
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Macro liixamples (Continued) 

The recursive property of macros Is illustrated by the factorial macro, FACT. 
Its input consists of a variable, v» and an integer, i, wtere the following is com- 
puted: 

v=J. I 
using the recursive formula 

y =2 * (i-1) I 

The macro expands as follows: 

Until the input integer becomes 1, the second conditional e3q)ands and re- 
cursively calls FACT. (Note that when return is finally made after these 
calls, the macro will return the string 

t2 =(tl)*t2 ^ 

and terminate. ) When the input becomes 1, the first conditional expands and 
terminates its ejqjansion. This begins the succession of returns to each 
level at which a recursive call was made, in the process computing 1 f 
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Macro Examples (Continued) 



.MACRO FACT 

.DO t 1 = = 1 

tS= 1 

.ENDC 

.DO T1<>1 

FACT tl-l,TP 

t 2= ( t 1 )*t2 

.ENDC 
% 

FACT 6, T 

0(^0000 .DO 6==1 

1= 1 

.ENDC 

000001 .DO 6<>1 

FA CT 6-1,1 

000000 .DO 6-l==l 
1= 1 

.ENDC 

000001 .DO 6-l<>l 
FACT 6-1-1,1 

000000 .DO 6-l-l==l 
1= 1 

.ENDC 

000001 .DO 6-l-l<>l 
FA CT 6-1-1-1,1 

000000 .DO 6-l-l-l==l 

1= 1 

• ENDC 

00000 1 .DO 6-1-1-10 1 

FACT 6-1-1-1-1,1 

000000 .DO 6-1-1-1-1==! 
T= 1 

.ENDC 

000001 .DO 6-l-l-l-l<>l 
FACT 6-1-1-1-1-1,1 

000001 .DO 6-1-1-1-1-1-^=1 

00 0001 1= 1 

.ENDC 

000000 .DO «.- 1 - - 1 - - ) <> 1 

FACT 6-1-1-1-1-1-1,1 
1= C 6- 1-1-1-1-1)*! 

• ENDC 

000002 1= (6-l-l-l-n*T 

.ENDC 
000006 1= (6-1-1-1)*! 

.ENDC 
000030 1= (6-l-l)*I 

.EM DC 
000170 1= (6-l)*I 

.ENDC 
001320 1= (6)* I 

.ENDC 5.^^ 



Macro Examples (Continued) 

A macro to output "packed decimal" is given next. It illustrates a number of useful 
techniques for use within macros. 

In packed decimal, each decimal digit is represented as a 4-bit binary nibble. The 
sign of the number always occupies the least significant nibble. The translation of 
of decimal to 4~bit binar" '" 



decimal 


4 -bit binary 


+ 


0011 


- 


0100 





0000 


1 


0001 


2 


0010 


3 


0011 


4 


0100 


5 


0101 


6 


0110 


7 


0111 


8 


1000 


9 


1001 



The input to PACK is the decimal string of digits, separated by spaces, followed by 
an explicit sign (+ or -) and the precision in Nova words. The macro produces the 
output least significant v/ord first. 

Some further explanation is necessary. 

1. The input radix within the macro must be decimal. Therefore, it 
is saved, set to decimal, and restored within die macro body, 

2. To present the output as 4-bit nibbles, the output radix within the 
macro must be hexadecimal . Therefore, the output radix is also 
saved, set to hexadecimal, and restored. Note the order of the save 
for these radices is the opposite of the order of the restore. (See 

. PUSH, . POP descriptions in Chapter 4. ) 

3. Many statements are assembled with; eacb macro call, but expansion is 
inhibited except for the storage words assembled. 
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Macro Examples (Continued) 

i PACKED DECIMAL 



; CALL : 

; P A CK D D . 

i WHERE D'S REPRESENT DIGITS* 

' W THE NUMBER OF WORDS. 



D S,W 
THE SIGN 



(+ OR -)* AND 



♦* 



1 = 
J= 
B= 
W= 
J= 



W=: 

B= 
J= 



W= 
B= 





** 




% 




000100 


00042 


3453 


00041 


0012 


00040 


0000 


00045 


3454 


00044 


0012 


00043 


0000 


00049 


3214 


00048 


0654 


00047 


0000 


00046 


0000 



.MACRO 


PACK 






.PUSH 


.NOMAC 






.NOMAC 


1 






.PUSH 


.RDX 






.PUSH 


.RDXO 






.RDX 


10 






.RDXO 


16 






.ARGCT 








I-l 








11 








3+("tJ- 


"+/2) 






J-1 








.LOC 


.+tl-l 






.DO 


tl 






.DO 


B+1/4 






W+0tJBB 








B-4 








.DO 


J<>0 






J-1 








.ENDC 








.EN DC 








.NOMAC 









W 








.NOMAC 


1 















15 








.LOC 


.-2 






.ENDC 








.LOC 


.+tl+l 






.RDXO 


.POP 






.RDX 


.POP 






.NOMAC 


.POP 






.LOC 


100 






PACK 


12 3 4 


5 


+ ,3 


W 








W 








W 








PACK 


12 3 4 


5 


',3 


W 








w 








w 








PACK 


6 5 4 3 


2 


1 - 


W 








w 








w 








w 
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Macro Examples (Continued) 







PACK 


0004F 


7 683 


W 


01 0004E 


0032 


W 


02 0004D 


0000 


w 


03 0004C 


0000 


w 


04 0004B 


0000 


w 


03 0004A 


0000 


w 


06 







3 2 7 6 8 +> 6 
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Macro Examples (Cantinued) 

A powerful macro, used to associate a specified field layout with a given name, is 
given below. The macro, VFD, is used to define a new macro named as the first 
argument in the call to VFD. Subsequent use of the name given in the VFD call 
generates a 16 -bit storage word having a primary value to which fields are assembled 
as described in the call to VFD. The call is of the form: 



VFD A <type_name > <sp > <^rimary_value Xsp > <f ield right bit ><sp > 

<fielimask><sp>. . . <field. right bit ><sp ><f ield. mask> <sp> . . . 



The 3rd, 5th, . . . arguments specify the rightmost bit positions of the 1st, 2nd, . . . 
fields. The 4th, 6th, . , . arguments specify the field masks for the 1st, 2nd, , . . 
fields. To assemble the fields in the proper bit positions, with overflow and field 
zero checking, a call is made of the form: 

<type_name >A <f ieldJL ><sp ><field_2 ><sp > . . . 

The example below defines a <t3^e_name > of SPECL. This name is for words of the 
following layout: 






1 2 3 


4 


5 i 


) 7 


8 


9 


10 


11 


x2 13 14 15 


1 


<field_l> 




<field_2> 



The definition of VFD is: 
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Macro Examples (Continued) 
.MACRO VFD 
1 = 4 



-% 



-% 



-% 



.DO .ARGCT/2-1 



1 = 1-1 



1 = 1 + 1 



1 = 1 + 2 



.ENDC 



.MACRO tl 

**.PUSH .NOMA 
**.NOMA 1 
VALU=t2 
J=l 



.MACRO tl 

.IFN tl>=«-tj 

MASK=tI 
DATA^*-tJ 



.MACRO tl 



.DO l5.-tl 
MASK=MASK*2 
DATA=DATA*2 
.EiMDC 



MACRO tl 

.IFN VALU&MASK 

ERROR CFIELD N0N-2ER0] 

.ENDC 

.IFE VALU&MASK 
VALU=(VALU&(-MASK-1))+DATA 
.ENDC 
-ENDC 



•IFE tl>=-tj 

ERRORC FIELD OVERFLOW] 

.ENDC 



.MACRO tl 
J=J+1 



.MACRO tl 

♦♦.NOMA 

VALU 

♦♦.NOMAC 'POP 
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Macro Examples (Continued) 



.MACRO ERROR 

**.PUSH .NOMAC 
♦♦.NOMA 

JF ^F ^p ^r ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F "^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F ^F 

J t 1 t2 t3 t4 t5 1 6 t7 tg r9 

{♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦ilc^^^^^^^^^^*^^ 

♦♦.NOMAC .POP 



5-16 



Macro Examples (Continued) 

The call to define SPECL produces: 

.MACRO SPECL 

**,PUSH ,NOMA 
**.NOMA I 
VALUB100000 



X 

wwifciklifig ,uO ,ARijCT/2-l 



% 



% 



.MACRO SPtCL 

.IFN 7>iAj 

MASK«7 

OATAbaJ 



.MACRO SPECL 



.UQ 15.-3 
MASK»MASK*2 
DATA«DATA*2 
.ENDC 



.HACRu SPECL 



.ENDC 



.IFN VALU&MASK 

EHROR tPIELD NON-ZEROJ 

,£NOC 

.IFE VALUSMASK 

VALU"CVALUiC-MASK-l))<fDATA 
• ENDC 
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Macro Examples (Continued) 



ti k-l k5 W 



kil Ii6 1.1 (.3 5 



w ifl tLi vO W & 



i0 (d lO 1^ 1 1*1 



l8l*2 



.tNOC 



I»I-1 



1 = 1 + 1 



1 = 1 + 2 



.tlVUC 



,IFt 7>sAj 

ERROR IFIELD DVEHFLDW] 

.tNQC 



.MACRO SP£CL 
J«J+l 



.nACRo specu 

,IFN 17>«AJ 

HASKal7 

OaTasaJ 



,HACRQ SPtCL 

.DO 15.-15. 
MASK»MASK*2 
0ATA8DATA*2 

.tNDC 



.MACRO SPtCL 



,1FN VALU&MASK 

ERROR [FIELD NDN-ZEROJ 

,tNDC 

.IFE VALU&MASK 

VALUsCVALU&(-MASK-l))+DATA 
,£NDC 



.tNUC 



,IFt 17>«AJ 

ERROR tFIELO OVERFLOW] 



9 im'-'V \0 



.MACRO SPfcCL 
JsJ + l 

.MACRO SPtCL 

**.NOhA 

VALU 

**,NO«ACi 



iPOP 
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And, finally, calls of SPECL for fields having values of 1, 1 and 7, 17 gives: 



SFECL 1,1 

SPeCL 7,17 
fcl"?v;'i^ii 17^1(^17 VALU 
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GENERATED LABELS 



In non- string mode, each occurrence of the character $ is replaced by three 
characters from the set 0-9, A-Z. The three characters are determined by 
converting a count of the number of macro calls in radix 36 to ASCII. In 
nested macros, the replacement string for $ in the outer macro is saved and 
restored upon completion of the expansion of the inner macro. $ can therefore 
be used, for example, to generate unique labels in macros. When used in 
labels,$ should generally not be the first character as the first replacement 
character may be a digit. 



Example : 





. MACRO X 


X$: 


tl 


% 






. MACRO Y 


Yl$: 


1 1_L» O 


T J.TT/i 




X[tZ] 


Y2$: 


f3+t4 


% 






.NREL 


A$: 


123 




Y[l,2,3,4] 


B$: 


456 




Y[5.6,7,8.] 
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All memory reference instructions must specify an address field. Tliis address is 
used to: 

1. Access the contents of the memory location in the case of an LDA. 

2. Modify the memory location in the case of an STA, ISZ, or DSZ. 

3. Transfer control in the case of a JMP or JSR. 

Often, however, the programmer merely wishes to specify the contents of a memory 
location and is not concerned about its address. This is referred to as a 
literal reference. 

Literals are permitted for all memory reference instructions. The macro assembler 
dumps these literals and assigns memory locations using the first and subsequent 
. ZREL locations available after pass 1. Therefore, all literal references are 
directly addressable. 

The syntax of a literal reference is as follows: 

<mem_ref >f <ac >, }= < statement > 

Note that a literal may be any expression or statement. 

Frequently literals are used to load an accumulator with some constant. For example, 

LDA 1,=3 
indicates that the programmer wishes to load ACl with the value 3. 
Expressions are acceptable 

LDA 0,=lB(>4-"A/2 
indicates that the programmer wishes to load AGO with the value 40040. 
Statements are also acceptable: 

LDA 1,=SUBZ# 2,3,SNC 
indicates the programmer wishes to load ACl with the value 156433. 
The previous examples have given absolute expressions as literals. However, any 
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LITERALS (Continued) 
relocatable expression is legal. 

.NREL 
A: 

LDA 2,= A 

indicates the value of "A" is to be loaded into the index register 2. K the programmer 
needs a byte pointer to a text string labeled "TX" for example, it is a simple matter: 

LDA 1,=2*TX^ 



TX: .TXT "TEXT STRING" ^ 
The use of a label as a literal can make subroutine communication without concern 

t,^-^ r^AA-vt^xctcinn- ^ffe\fci cimT-vIo Tf o /^o11 Yr\ "YOR" ia i-n Vifi marip' anrl "YOR " mau not 

XV^X CHJV-IX \^ O O J-ii-K ^^XXWXO k:7XXXJl^XV^. iJL t* w«^j.x 1.V ^a-v^AV a i-r i.v *^v ***«-^_v*.- w^^u- ^ ^ -v ^ « ^^^«.^ lAX^L 

be directly addressable, the following creates a directly addressable reference 

JSR @=XOR 

A literal can be used as a temporary. For example 

STA 1,=0 

would allocate a page zero word containing 0. Obviously, since can always be gen- 
erated by a SUB instruction, the programmer does not intend to define a constant 
of 0. He has merely generated a temporary address, using =0 by convention. 
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CHAPTER 6 



OPERATING PROCEDURES 



LOADING THE MACRO ASSEMBLER 

The Macro Assembler is supplied as three files of dumped tapes of the RDOS system. 
The files are: 

MAC.SV - Macro Assembler 
MACXR.SV - Cross Reference Listing 
MAC. PS - Permanent Symbols 

THfi filpa miiol- Kp T OAT^iaH Ktt *-1-i^ ^-itnfs-*^ 'K^-Pr>«^ ^-u^ /^t t ^j t^ «■ a ri f ■• 

— >__ „^ „c ^w^^i^cL. 3^y i.iiC i*oCi jjCiurfc me \w/j_,i i^uiiimaiiu, ivi^iL-, uctn ue used 

to assemble programs. 

MAC COMMAND LINE 

The command to assemble files using the Macro Assembler has the format: 



MACAfilename -f A ... filename f 
1 n 



The MAC command line is used to build a command file as described in the 
the RDOS User's Manual, 093-000075. 

A MAC command causes one or more source files (filename.) to be assembled. Output 
may be a relocatable binary file, a listing file, or both. The command name MAC 
must be used in assembling programs; the name MAC cannot be changed. 

Command line switches, conventions, and examples are given below: 

Switches: 



Global: 



By default, output of an assembly is a relocatable binary file with- 
out a listing file. 



/A 
/L 



/N 



add semi-permanent symbols to cross reference. 
Hsting file is produced. Listings Liclude a cross ref- 
erencing of the symbol table. MACXR. SV must be 
available on disk, 
no relocatable binary file is produced. 
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MAC COMMAND LINE (Continued) 



Global Switches: /u 
(Continued) 

/E 

/S 



/O 



user symbols are jncluiied in) the relocatable binary 

output. 

error printouts on the TTO are suppressed unless there 

is no listing file. 

skip pass 2 and save a version of the assembler's symbol 

table, MAC. PS, that contains new symbols and macro 

definitions. (See page 6-3. ) 

override all listing suppression controls. 



Local Switches : 



/E - error output is directed to the given file name. 

/B - relocatable binary output directed to the given file name. 

/L - Hsting output directed to the given fUe name. 

/S - skip this file on pass 2 of assembly (This switch should be 

used only if the file does not assemble any storage words. 

Macro definition files can be skipped on pass 2. ) 



Asterisk: 
Errors: 



Not permitted, 

NO SOURCE FILE SPECIFIED. 
ILLEGAL FILE NAME. 
FILE DOES NOT EXIST. 
FILE ALREADY EXISTS. 
FILE WRITE PROTECTED. 
FILE READ PROTECTED. 
SWITCH ERRORS. 



(input file) 

(output file) 

(output file) 

(input file) 

(listing and binary files cannot be 

the same) 



Extensions: On input, search for filename „ SR . If not found, and the filename did 

not have an extension, search for filename . 

On default output, produce filename . RB for relocatable binary and 
filename. LS for listing (global L switch), where filename will be 
the name portion of the first source file specified without a /S local switch. 
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MAC COMMAND LINE ( Continued) 
Examples: MAC Z 

causes assembly of source file Z, producing a relocatable binary file 
called Z. RB . 

MAC LIB/S ABC $LPT/L 

causes assembly of relocatable binary fUes A, B, and C. File LIB 
contains macro definitions and thus is skipped during the second pass. 
A listing and cross-referenced symbol table are produced on the line 
printer. 

The standard semi -permanent symbols (macro, floating point, and 
RDOS.) are defined in three source files, NBID.SR, FPID.SR, and 
OSID.SR. To incorporate these symbols into the macro assembler, 
use the following command: 

MAC/S/N NBID FPID OSID ) 

THE MACRO ASSEMBLER'S SY MROT, TABL E FILES 

The macro asse mbler maintains its symbol table and macro definition table in a 
disk file called MAC.ST. At the start of each assembly, the "permanent" symbol 
table file, MAC. PS, is copied to create MAC.ST. Thus, MAC. PS can be used to 
save symbol and macro definitions from one assembly to the next. 

When the pseudo-op . XPNG is seen, MAC. ST is deleted and a new, empty MAC. ST 
is created. The global /S switch causes the assembler to terminate at the end of 
pass 1 and to rename MAC. ST to MAC. PS. 

Therefore, the programmer can create an entirely ikw set of retained symbols 
and macros by performing MAC/S on a source file beginning with an . XPNG; or 
he can add to his retained symbols and macros by performing MAC/S on a source 
file not containing an . XPNG. 

The symbol table portion of MAC. ST can hold approximately 8000 symbols while 
the macro definition table portion can hold about 1/2 million bytes of macro defi- 
nition strings. 
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APPENDIX A 

ERROR MESSAGES 

Assembler error messages are single letter codes that are output in the first three 
character positions of a listing line. The first error code will appear in character 
position three of the line in which the error occurred. If there is a second error, 
the code is output in character position two, and if there is a third error, the code 
appears as the first character of the listing line. 

Assembler errors are output as part of the assembly listing to any device and also 
to the teletypewriter. If the listing is suppressed, the error listing is always out- 
put at the teletypewriter. If there is a listing device, output of errors at the tele- 
typewriter can be suppressed. Certain errors encountered on the first pass will 
be output, since they may not be detected on the second pass. 

The list of possible assembler error codes is as follows. 

A Address error. 

B Bad character. 

C Macro error. 

D Radix error. 

E Equivalence error. 

F Format error. 

G Global error. 

I Parity error on input. 

K Conditional or repetitive assembly error 

L Location counter error. 

M Multiply defined symbol error, 

N Number error. 

O Overflow field or stack error. 

P Phase error. 

Q Questionable line. 

R Relocation error. 

U Undefined symbol error. 

X Text error. 



Some typical causes of error codes are given on pages following. However, it is not 
possible to pinpoint all possible causes of assembly errors. 
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ADDRESSING ERROR (A) 

An A flags an error appearing in a memory reference instruction (MRI) and indi- 
cates an illegal address. For example: 

1. A page zero relocatable instruction references an NREL 
address. 

Example: 

.NREL 

mm3'mm\a 6: 10 ;nrel address 

.EREL 
A00R)0RI -044000 STA 1,G iZRZL ADDRESS 

2. A normal relocatable address references an address outside 
the range of the program location counter's relative address 
range: (.-200 < displacement < .+177) 

Example: 

• NREL 
A00004 '020000 'LDA 0*:Y ^Y IS OUTSIDE THE 

000423'. LOC .+416 i INSTRUCTION ' S RANGE 

00423'000002 Y: 2 

BAD CHARACTER (B) 

Error code B indicates an illegal character in some symbol. The statement con- 
taining a symbol that has an erroneous character will be flagged with a B. A bad 
character error often leads to other errors as shown in the example below: 

Example: 

.NREL 
B00000'024023 .A%: LDA 1»23 iZ IN LABEL SYMBOL CAUSES 

;BAD CHARACTER ERROR 
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MACRO ERROR (C) 

The macro error code C occurs under the following circumstances: 

1. At attempt is made to continue the definition of a macro when 
it is not the last macro defined. 

Example: 

. MACROAA) 

< macro definitions'^. 



.MACROAA) 

< macro def inition> % 



; LEGAL CONTINUATION 



. macroab) 

< macro_def inition> % 
C . MACROAA) 



;ILLEGAL TO CONTINUE ANY 
;MACRO EXCEPT B 



2. A macro error will occur if a macro exhausts assembler working 
space. However, this should only occur if the macro definition 
causes endless recursion. 
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RADIX ERROR (D) 

Error code D occurs on a . RDX or . RDXO pseudo-op when . RDX contains an 
expression that is not in the range 2-20 and when . RDXO contains an expression 
that is not in the range 8-20, or when a digit is used that is not within the current 
input radix. 

Examples: 



000030 .RDX A*6 
.END 



000002 .RDX 2 
D00000 00001 3 B: 35 



EQUIVALENCE ERROR (E) 

Error code E occurs when an equivalence statement contains an undefined symbol 
on the righthand side of the equals sign. This may occur on pass one before the 
symbol on the righthand side has been defined or on pass two if the symbol is 
never defined. 

Examples: 



EUU A = B iPASS OiNJE; B UNDEFINED 

01 .NREL 

EU 000000 A=B ;PASS TWO; B UNDEFINED 

.END 
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FORMAT ERROR (F) 

An F error results from any attempt to use a statement format that is not legal 
for the type of statement and often often occurs in conjunction with other errors. 



WTVy^s-*^ n -P^. . _____._.. 

..111-11 a. njxiiia.L CJ.XUX u>-uuxo ill all uiaLJ-uciiuii, uie coue generacea Dy tne mstruction 
reflects only those fields assembled before the error was detected. 



Examples: 

F 143PI0f^ ADD 2 iNOT ENOUGH OPERANDS 

F0!^4g5'041 410 STA 0,10*3*Si\)C J TOO MANY OPERANDS AND IvRONG 

; OPERAND FOR INSTRUCTION TYPE 

F 00':^00(?l-.ZREL -1 ;ZREL CANNOT HAV/E ARGUMENT 

06051^ .DUSR C » DIAS 0*PTR 
F00426'0 60512 C 1 i ATTEMPT TO GI^E ARGUMENT TO A 

J SYMBOL DEFINED IN A .DUSR 
iPSEUDO-OP 



EXTERNAL/INTERNAL SYMBOL ERROR (G) 

A G error code results when there is an error in the declaration of an external or 
entry symbol. 

Examples: 



GU .ENT HH 5HH NEVER DEFINED 

02 

iAA IS ENTRY IN PROGRAM IN 

; WHICH THE SYMBOL IS DECLARED 

J EXTERNAL 



.ENT 


HH 


.END 




AA; 




.EXTN 


A A 


.END 
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INPUT (PARITY) ERROR d) 

An I error code occurs when an input character does not have even parity. The 
assembler will substitute a back slash ( \) for any incorrect character and flag 
the line containing the error with an I. 

CONDITIONAL ASSEMBLY ERROR (K) 

A K error code occurs when an . ENDC pseudo-op does not have a preceding . DO 
or . IFx pseudo-op. 



Example: 



000002 .DO 2 



K 



ENDC 
ENDC 



LOCATION ERROR (L) 

The L code occurs when an error is detected in a statement that affects the location 
counter. 



Examples: 



1. The expression in a . LOG evaluates to less than zero or cannot 
be evaluated on the first pass of the assembler. If the expression 
is outside the range of locations or cannot be evaluated, the . LOG 
is ignored, and the location counter is unchanged. 

L 177777 .LOC -1 

2. The expression in a . BLK statement cannot be evaluated on the 
first pass of the assembler or its value, when added to the cur- 
rent value of the program location counter, is less than zero. 
If an L error occurs, the . BLK statement is ignored and the 
location counter is unchanged. 

77711 '000000 a: 
L 100012'. BLK .+100 
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MULTIPLE DEFINITION ERROR (M) 

The M code flags a multiply defined symbol. Within an assembly program a symbol 
appearing, for example, as a label cannot be redefined as another unique label. 
Any multiply defined symbol will be flagged M at each appearance of the symbol. 

Example: 

« I'JHEL 
M00000'000000 A: 
PM00001 '000001 A: I 

Note that the second definition of A is also flagged as a phase error (P) on the 
second assembler pass. (See Phase Error). 

NUMBER ERROR (N) 

The N code is given when a number exceeds the proper storage limitations for the 
type of number; the N error occurs under the following conditions: 

1. An integer is greater than or equal to 2 . The number is 
evaluated modulo 2-^", 

Nr^i^iM A i'?!''T*^'5'T3 65539 

2. A double precision Integer is greater than or equal to 2^"^. The 
number is evaluated modulo 2^2. 

Nq0':^05 167153 4000000'^0P5(7|.D 
0P4Rn5l 

75 

3. A floating point number is larger than?. 2*10 . 



■V'^TRl 3 •'^77777 7.3E75 
177777 
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FIELD OVERFLOW ERROR (O) 

A field overflow error occurs when variable stack space is exceeded, when a . TOP 
or . POP is given with no previous . PUSH, or when a instruction operand is not within 
the required limits, e.g. , 0-3 for an accumulator, 0-7 for a skip field, etc. When 
overflow occurs in an instruction field, such as an accumulator field, the field will 
remain unchanged. 

Examples: 

O0i1?)n'?l 02077 5 LDA 5>.-3 

014000 .DIAC R=14300 
000001 014030 R 1 

FO 000000 .POP 

FO 000000 .TOP 



PHASr, mvKUK (r) 



A phase error is caused when the assembler detects on pass 2 some unexpected 
difference from the source program scan on pass 1. For example, a symbol 
defined on the first pass which has a different value on the second pass will cause 
a phase error. If, as in the example, a symbol is multiply defined, the M error 
flags each statement containing the symbol while the phase error will flag the 
second ( and any subsequent attempt to redefine the symbol. ) 

Example: 

.NREL 



M00001 '000000 B: 
PM00002'000000 B: 
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Questionable line (Q) 

A Q error occurs when a # or @ atom has been used improperly or when a ZREL 
value is used where an absolute value is expected. 

Examples: 

nw^q:iH 113r4Hf5 ADD 3,@o MNCOKRECT^USE OF SPECIAL ATOH 

iCAUStS w EF^hUK 

.2REL 
02I000-002I010 FLD: .BLK 10 

.NREL 
Q00000' 000000 LDA 0jFLD>2 J ASSEMBLER EXPECTS ABSOLUTE 

JFOR FLD 
.END 

RELOCATION ERROR (R) 

The R error indicates that an expression cannot be evaluated to a legal relocation 
type (absolute, relocatable, or byte relocatable as described in Chapter 3) or that 
the expression is a mix of ZREL and NREL symbols. 

Example: 

• NftEL 

000 ' 0000 10 (£ . J (7) 

00001 • 000000 "E+E 
R0000g' 000000 'S+E+E 



;CONTE\'TS ABSOLUTE 

;CO:nJTENTS NREL BYTE 

iCOi^TENTS MOT ABSOLUTE, RELOCATABLE 

J OK BYTE RELOCATABLE 



UNDEFINED SYMBOL ERROR (U) 

The U error occurs on pass 2 when the assembler encounters a symbol whose value 
was never known on pass one. The error occurs on pass one when the definition of 
a symbol (by equivalence) depends upon another symbol whose value is unknown at 
that point. 



Example : 



U00022 '030000 LDA 2,B' 



;WHERE B IS UNDEFINED 



See also the example given for equivalence error E. 
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TEXT ERROR (X) 

An error occurring in a string is flagged as a text error (X). A text error occurs 
if the expression delimiters < and > within a string do not enclose a recognizable 
arithmetic or logical expression. (Relational expressions cannot be used within 
text strings.) 

Examples: 

y^mmm (^47516 .txt #no space alloived in an expression < x+ y># 



y.,,m<^03 054105 .TXT ^EXPRESSIONS MUST HAVE OPERANDS < + ># 



XmmA3 352101 .TXT .--/ATTEMPT TO USE RELATIONAL OPERATOR <X<=Y>, 
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APPENDIX B 



RELOCATABLE BINARY BLOCK TYPES 



The relocatable binary output of the Macro Assembler is divided into a series of blocks. 
The order in which blocks appear, if each type of block is present, is shown in the 
figure following. 



Title Block 



Labeled COMMON Blocks 



Entry Blocks 



Unlabeled COMMON Blocks (. CSIZ) 



External Displacement Blocks 



Relocatable Data Blocks 

Global Addition Blocks 

Global Start and End Blocks 



Normal External Blocks 



Local Symbol Blocks 



Start Block 



The relocatable binary output must contain at least a Title Block and a Start Block, 
Presence of one or more of the other types of blocks will depend upon source input. 
The pages following describe the content of each of the blocks. 

The first word of each block contains a number indicating the type of block. The num- 
ber is in the range 2 - 17 . Block type formats are described later in the appendix in 
numerical order. 
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The second word of each block is the word count. It is always in two's complement 
format, and the counter never exceeds 15. Where the word count is a constant for 
every block of the particular type, the word count constant is shown in parentheses 
in the format. 

Words 3-5 are reserved for relocation flags,, The relocation property of each address, 
datum, or symbol is defiaed in three bits. For example, for a Relocatable Data Block, 
bits 0-2 of word 3 apply to the address, bits 3-5 apply to the first data word, bits 6-8 
apply to the second data word, etc. The meaning of the bit settings is given in the table 
following. 



Bits 


Meaning 


000 


Illegal 


001 


Absolute 


010 


Normal Relocatable 


Oil 


Normal Byte Relocatable 


100 


Page Zero Relocatable 


101 


Page Zero Byte Relocatable 


110 


Data Reference External Displacement 


111 


Illegal 



All other blocks use bits of word 3 only and set words 4 and 5 to zero. 

Word 6 contains a checksum, such that the sum of all words in the block is 0. 

For those blocks containing user symbols, each symbol entry is three words in length. 

The first 37 bits of the three -word entry contain the user symbol name in radix 50 
form. (See Appendix C for radix 50 notation. ) The last five bits of the second word 
are used as a symiol type flag, where the currently defined types are: 



Bit 


Meaning 


00000 


Entry Symbol 


00001 


Normal External Symbol 


00010 


Labeled Common 


00011 


External Displacement Symbol 


00100 


Title Symbol 


00101 


Overlay Symbol 


01000 


Local Symbol 



The setting of the third word allocated for each user symbol entry varies with the 
type of block and is described in the format writeups of each blocks 
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RELOCATABLE DATA BLOCK 





Word 


2 


1 


word count 


2 


relocation fla^s 1 


3 


relocation fla^s 2 


4 


relocation flags 3 


5 


checksum 


6 


address 


7 


data 


8 


data 


9 


• 
• 
• 


* 
• 
« 


data 


word count +6 



Contents of the relocation flag words (words 3-5) are as described previously. 
ENTRY BLOCK (. ENT) 



Word 







3 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


relocation flags 3 


5 


checksum 


6 


symbol in 


7 


radix 50 j flags 


8 


equivalence 


9 


• 
• 
• 


• 
• 
• 


symbol in 




radix 50 flags 




equivalence 


word count +6 



Note that the relocation flags for the Entry Block are as previously described, except 
that they apply to the third word of every user symbol entry. For Entry Block user 
symbols, the third word of the user symbol entry is used for the equivalence of 
entry symbol. 



The overlay block , ENTO is the same as the . ENT block except for different flags 
value in word SI (word 8, etc. ). 
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EXTERNAL DISPLACEMENT BLOCK (. EXTD) 

Word 







4 


1 


word count 


2 


6 


3 


6 


4 


6 


5 


checksum 


6 


symbol in 


7 


radix 50 flags 


8 


77777 


9 


• 
• 
• 


• 
• 
• 


svml)ol in 




radix 50 flags 




77777 


word count +6 



The third word of each user symbol entry in the External Displacement Block is set to 
77777. 



NORMAL EXTERNAL BLOCK (. EXTN) 



Word 







5 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


relocation flags 3 


5 


checksum 


6 


symbol in 


7 


radix 50 | flags 


8 


adr. of last reference 


9 


• 
• 
• 


• 
• 
• 


symbol in 




radix 50 flags 




adr. of last reference 


word count +6 



The third word of each user symbol entry in the Normal External Block contains the 
address of the last reference. Relocation flags are used as in . ENT blocks. 
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START BLOCK 


Word 










6 


1 




word count (-2) 


2 




relocation flags 1 


3 







4 







5 




checksum 


6 




address 


7 







8 


TITLE BLOCK (. TI 


TL) 


Word 




7 


1 




word count (-3) 


2 







3 







4 







5 




checksum 


6 




title in 


7 




radix 50 flags 


8 







9 



The third word of the user symbol entry for a title is set to 0. 



LOCAL SYMBOL BLOCK 



Word 







10 


1 


word count 


2 


relocation flags 1 


3 


relocation flags 2 


4 


relocation flags 3 


5 


checksum 


6 


symbol in 


7 


radix 50 flags 


8 


equivalence 


9 


• 
• 
• 


• 
• 


symbol in 




radix 50 flags 




equivalence 


word count +6 



The third word of every symbol entry is used for the equivalence of local symbols. 
Relocation flags are used as in . ENT blocks. 
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LIBRARY START AND END BLOCKS 

The format of the Library Start and Library End Blocks differs from the format of other 
relocatable binary blocks, since the blocks are not generated by the assembler and are 
thus not internal to the binary output program but mark the beginning and termination 
of a file of binary output programs that constitutes a library file. 



Library Start Block word 



11 



-11 



Library End Block 



1 
2 
3 
4 
5 
6 



12 











•12 



LABELED COMMON BLOCK (. COMM) 



13 



word count (-4) 



relocation flags 1 











t;iici;js.sum 



symb ol in 
radix 50 



flags 







expression value 



Bits 0-2 of the relocation flags (word 3) apply to the expression ( <exp> following 
. COMM). All other bits of the word are zeroed. 

GLOBAL ADDITION BLOCK (. GADD) 



14 



word count (-5) 



relocation flags 1 








checksum 



address 



symb ol in 
radix 50 I 00000 







expression value 



Bits 0-2 of the relocation flags (word 3) apply to the address and bits 3-5 apply to the 
e3q)ression. All other bits of the word are zeroed. 
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UNLABELED COMMON SIZE BLOCK (. CSIZ) 





Word 


15 


1 


word count (-1) 


2 


relocation flags 1 


3 





4 





5 


checksum 


6 


expression value 


7 



Bits 0-2 of the relocation flags (word 3) apply to expression ( < exp > following 
. CSIZ). Ail other bits of rhe word are zeroed. 

GLOBAL LOCATION START AND END BLOCKS (. GLOC) 

Start Block Word End Block 









16 


1 


-3 


2 





3 





4 





5 


checksum 


6 


symbol 
radix 50 


in 


7 


tooooo 


8 





9 



17 



-1 











checksum 
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APPENDIX C 
RADIX 50 REPRESENTATION 

Radix 50 representation is used to condense symbols of five characters into two words 
of storage using only 27 bits. Each symbol consists of from 1 to 5 characters and a 
symbol having five characters may be represented as: 

a^a^a^a^a^ 

where: Each a. may be one of the following characters: A-Z (26 characters) 

0-9 (10 characters) 
. or ?(2 characters) 

All symbols are padded, if necessary, with nulls. Each character can be trans- 
lated into octal representation as follows: 

Character a. Translation b. 
1 1 

null 

to 9 1 to 12 

AtoZ 13-to 44„ 

< 

If a. is translated to b., the bits required to represent the symbol can be computed 
as follows: 

N^ = (((b^*50+b3)*50)+b2 

3 
^1 rr.o^^^r>,„r>, = (50) - 1 = 174777, which can be represented in 16 bits (one word) 

N2=(b^*50) + bQ 

2 
^2 maximum ~^^^^ ~ ^ = ^077, which can be represented in 11 bits. 

Thus the symbol can be represented in 27 bits of storage, as shown in Appendix B 
in the binary output block formats. 
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APPENDIX D 

BASIC SYNTAX SUMMARY 

The basic syntax of the macro assembler is defined here in Backus Normal Form notation. In following the language 
definition note that the last term of each list of alternative terms is defined in full then the next to last etc 
This summary covers Chapter 2 and the permanent macro assembler symbols. All EX3C -defined semi-permanent 

< input mode > ;:= < string mode > | < normal mode > 
<normal_mode> ::= <atom> ... <atom> 

<atom> ::= <syiiibol > ] <number> | <terminal > | < special atom> 

<special_atom> ::= @| #| ** 

<terminal> ::= <break> 1 <operator> 

<operator> ::= <relational op> | <logical op> \ <arithmetic op> 

< arithmetic_op> ::= + | - | * 1 / ! B 

< logical op ::= & | ! 

^iciciuLUiid-i up^' ;:= ^ j ^= | =| *- | <-= j ^> 
<break> ::= (| ) | [ | ] 1 ; 1 = I t 1 ^ |<c_sp> | <sp> 

< sp> ; := , 1 1 tabulation 
<c_sp> ::= <sp>... <sp> 

<number> ::= <integer> | <floating point> 

<floating point> ::= <sign> <decimal digit>. . . <declmal digit > . <decimal digit>. . . <decimal digit> E <sign> 
< decimal digit > < decimal digit> 

<decimal_digit> ::=0|ll2|3|4|5|6l7|8l9 

<sign> ::= + ] - 

< integer > ::= < single precision integer > ] < double precision integer> 

< double_precision integer > ::= <sign> < decimal digit> <digit>. . . <digit> . D 

<digit> ::= <decimal_digit> |A|b|C|D|e|f|g|h1i|J 

<single_precision_integer> ::= " < character> ] ' <string>' | <sign> < decimal digit> <dlgit>. .. <digit>. ] ' <string> 

<string> ::= <character> . . . <character> 

<character> ::= <letter> | <decimal_digit> | <operator> | <break> ] <special_atom> 1 " | ' I \ I * I "^ 1 ? 

<letter> ::= A | B | C ... | Z,| a | b ... | z 

<symbol> ::= <initial_symbol_character > < symbol_character > . . . < symbol character > 

<symbol_character > ;:= < initial_symbol_character > |< decimal digit > | $ 

< initial_symbol_character> ::= < letter > | . | '? 

< string_mode > ::= < text_string> ] <macro_definition_string> | <comment_string> 
<comment_string> ::= ; <string> < comment terminator > 

< comment terminator > ::= )| * 

< macro_definition_string> : : = ^ MACRO < c_sp >< string > % 

<text_string> ::= <text_inltiator_op> <c_sp> < character_not_in_string> <string> <character_not_in_string> 

<text initiator op> ::= .TXT | .TXTEI .TXTF ] .TXTO 
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< permanent symbol> ::= <pseudo op> | < value > 

<value> ::= .ARGCT ] .PASS | . | . POP | .TOP j .MCALL 

<pseudo op>::= .TITL I .MACRO ] .PUSH | <radix_op> ) < symbol_table_op> | < location_counter_op> ] <text_op> 

" j <interprogram commumcation_op> | <file terminator_op> j <llsting_op> i <conditional_or_repeat_op> 

<conditional_or_repeat_op> ::= . DO ] . IFE | .IFG l-IFLJ .IFN ] . ENDC 

<listing_op> ::= . NOCON | . NOMAC | . NOLOC 

<file_terminator_op> ::= . END I .EOT 

<interprograin_commumcation_op> ::= . COMM | . CSIZ ] .ENT 1 . ENTO | .EXTD | . EXTN i . EXTU I .GADD 1 .GLOC 

<text_op> ::= .TXT 1 .TXTE | .TXTF] .TXTM 1 .TXTN| .TXTO 

<location_counter_op> ::= .BLK j .LOG | .NREL| .ZREL 

<symbol_table_op> ::= . DALC ] . DIAC ] . DIO ] .DIOA | .DMRj.DMRA j , D USR | . XPNG 

<radix op> ::= .RDX | .RDXO 
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NAME! NfllO.SR Part MUMfJERJ 090-0PI1482 

DESCWIPTIONI MOVA BASIC INSTRUCTION DEFINITIONS 



DOCUMENT NO, 

(»07«Pie)PI285 
0P!7-PI00322 



TITLE 

F-XTENOED ASSEMBLER 
Rons EXTENDED ASSEMBLER 
SOS EXTENDED ASSEMBLER 

REVISION HISTORV: 

REV. DATE 

m 1714/27/73 



COPYRIGHT fC) DATA GENERAL CORPORATION, 1973 
ALL RIGHTS RESERVED. 
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IINSTRUCTION OEFTNjTTON FIt,E 
lOEFlME STAWDARD 10 HEVICES 



,OUSR MOV BPil f MULTIPLV-DIVIHE 

,OUSR ^<APb2 M!?0i^/BlJC? MAP BQX 

,OUSR MAPPtsfi? ^MEMORY ALLOCATION AND PRDTfcCTION 

,DUSR MAPispi3 ; " 

.OUSR MAP2*:i4 ; " 

.OUSR MCAT«?I6 IMULTI-PROCeSSOR COMMUWICATIONS ADAPTER TRANSMITTER 

.OUSR MCARB07 ;HULTI-PR0CESS0R communications ADAPTER RECEIVER 

.OUSR TTI 8lP! ;TELETYPE READER/KEYBOARD 

.OUSR TTO »n ^TELETYPE PUNCH/PRINTER 

,DUSR PTP i\?. tPkPEn TAPE READER 

,DUSR PTP "IS »PAPER TAPE PUNCH 

.OUSR RTC aU IPEAL TIME CLOCK 

.OUSP PLT «!•! INCREMENTAL PLOTTER 

.OUSP COP »16 fCARO REAPER 

.OUSR LPT *i7 aiNE PRINTER 

.OUSR DSK s2£^ ;FIPST FIXED HEAO DISK CONTROLLER 

.OUSR ADCVSI21 M/D CONVERTER 

.DUSR MTA .g? IFIRST MAG TAPE CONTROLLER 

.OUSR DACV^SS »D/A CONVERTER 

.DUSR DCM b20 fDATA COMMUNICATIONS MULTIPLEXOR 

.OUSR OTY *-iOi FOUAD MULTlPLcXOR 

.DUSR IPMIB31 riBM 360/370 INTERFACE 

.OUSR IRM2«32 

.DUSR DKP 833 »FIflST MOVING HEAD DISK CONTROLLEP 

.OUSR CAS «34 ;FIRST CASSETTE CONTROLLER 

.OUSR IVT 135 IINTERVAL TIMER 

.DUSR IPS B36 f INTER-PROCESSOR BUS 

.DUSR DPI bUPI FDUAL processor INPUT 

.OUSR DPO B41 ;OUAL PROCESSOR OUTPUT 

.OUSR TTIlaSP" ISECOND TTY 

.OUSR TT01»!51 f 

.OUSR PTRl«52 ISECOND PAPER TAPE READER 

.OUSR PTP1BS3 ;SECOND PAPER TAPE PUNCH 

.OUSR PLT1B55 fSECONO PLOTTER 

.OUSR CDR1S56 ISECONO CARD READER 

.DUSR LPT1B57 ISFCQND LINE PRINTER 

.OUSR RSKlBfiP! fSECOND FIXED HEAD DISK CONTROLLER 

.OUSR MTA186? JSECOND MAG TAPE CONTROLLER 

.DUSR 0KPIB73 (SECOND MOVING HEAD DISK CONTROLLER 

.DUSR CAS1874 (SECOND CASSETTE CONTROLLER 

.OUSR FPU1«74 (SINGLE-PRECISION FLOATING POINT 

.OUSR FPI.i2a75 JDOUPLE-PRECISION FLOATING POINT 

.DUSR FPUB76 (FLOATING-POINT CONTROLLER 

.DUSR CPU 877 (CENTRAL PROCESSING UNIT 
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MULTIPLv/DIVIDE 
.DUSR MUL aCTSaat 

;QtTTNE MEMORY «EFE«llNiCE INSTRIJCTinKS THAT DONIT REQUIRE AC'S 

.OMR JMP B PiPMklaPI 
,OMR JSR»l?!!?)4«i?tPi 

,DMR nSZ*((il4t'*v^9» 

fOEFlNE MEMORY RFFErENCK INSTRUCTIONS THAT REQUIRE AC'S 
.OMRA lDAs?l2l^CTP)0 
.OHRA STABt?«4(?|y)!^Ci! 



ioefine the alc TNSTRUCTIOMS 



,OALC MOV«^?l?i00 

.UALC lNCs}(^14l?(0 

,OALC ADCsl3i?0(«tft 

,i3AL.C SuBslf^?4Plt;) 

,OALC ADnslwiSPit^Pl 

.OALC AmObi?i34i?|0 



lOEFIWE The 
,DUSR SxPaX 



ALC SKIPS 



.DUSR 
.OUSR 
..OUSR 
.liUSR 
.OUSR 
.OUSR 



S?C«? 
SMCs3 
SZR«4 

SnR«5 
SEZ«6 

SHN«7 
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TDfcFlNF THE in IMSTRIJCTIHnS 

.DloA nnA»pt*ini«pi 

,DlnA niHs')tnl4flM 
,0IDA Dir:3'^524Wi^ 



;0EFINF. THE 10 SKIP 
.Din SKPRMi^f34(^f^ 

,010 sKPrtzsf'^essaw 

,010 RKP^^i■<^6df>PlPl 
.Din St<POZs«P37oit^ 



TNSTPUCTIO^JS 



jOfcFINE SPECIAL INSTRUCTIONS 

.DUSR lMTfrN»NlDS CPU 

.DUSW INTDS«MIDC CPU 

.DIAC REAOSmOIA !?),CPU 

.DIAC !^TA■ DIP pijCPU 

,DIAC MSKOs DOB pl,CPU 

.DUSP TOPSTaDlCC ?,CPU 

,OUSP MALT* HOC a, CPU 



UNTERPUPT tNABLE 
flNTEPRUPT DISABLE 
IPEAD THE SWITCHES 
flNTERRUPT ACKNOWLEDGE 
fHASK OUT 
no RESET 
IHALT 



,EnT 
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NiAME: FPIO.SR PART N!.I^*BER: e!9^-0ai483 

OESCRIPTIO^I FLnATlMR PQlNiT INTERPRETER INSTRUCTION DEFINITIONS 



DOCUMENT NO, 

ap7-!'!00l64 
pl«7-fliBPI285 
Pt07«P!p! 91322 



DOCUMENTATION REFERENCES! 

TITLE 

FXTEMOED ASSEMBLER 
RDns EXTENOFD ARSEMflLER 
5ns EXTENOEr) aSSEHSlEk 

REVISION HISTORY! 

"EV, DATE 

M« W4/27/73 



COPYRIRHT (C5 DATA GENERAL CORPDRATION, 1973 
ALL RIGHTS RESERVEn, 
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I AfiSOLIiTt FLCjATImR INTERPPETE« INSTRUCT IO^AL ENTRIES 

.DUSP FtTK8 JSe *4 I ENTER 
.rMJSI* FINI. .ISP 9^ f INITIALIZE 



FLf^ATINt AI.C INSTRUCTIONS WJTH NOR^I AL IZt /NP NOR^'ALIZE OPTION 



.OALC 
.DALC 
.DALC 
,DALC 
.OALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
.()ALC 
.DALC 
.DALC 
.DM.C 
.OALC 
.OALC 



FnEGb 1 
FNERllBl 

Ff«nvs 1 

FMOVU«l 
FPOSb 1 

FABSbFP 
FOAHS«F 

Fpnsusj 

FMNS« 1 
FHNSU«l 
F$UB« 1 
FSl!Hll«l 
FADO« I 
FADDU*) 
FRNO" J 
Ft<NDU»l 



US P'.P! 
Pns ^■t? 

(>i J> pi CI (?t 
?34C"0 



FLOATING ALC INSTRIJCTinNS WITHOUT NDRMALl^E/NQ NHRMALIZE OPTION 



.DALC 
.OAlC 
.DALC 
r ONLV AVAILA 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
,PALC 
.DALC 
.DALC 
.DALC 
.DALC 
.OALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 
.DALC 



FLOATING POINT PACKAGE 



FMPV«l(?lt^l09i 
F P I V ■ I C^ i^ 2 ?* tl 
FHLV«lP!«3?i^ 
BLE WITH EVTENDED 
FALGkIPIP'C'S'^ 
FALOGsFALG 5t , ? 

FOLOGsFALG l^^.t? 

FATNBilfi'(?sl^4Pl 

FATANsFATN Cii , P! 

FDATAN«FATN , l?i 

FCOSBj?5-.pi6P' 

FDCDS«FCOS («,P! 

FSlN«iPi(c,l?«' 

FDSINbFSIN g,l?( 

FTAN8l«Pil4fi 

FDTAHesFTAM 0,?^ 

FEXPall?iC122!^ 

FOEXPbFKXP (?i,0 

FSGN«l?i(/>26e! J (WELD, INTER, ONLY) 

EHLVUPic^'SPis^ 

FSDftBlpi^?41^ 

FSPRTsFSDR 0,'^ 

FDSQRsFSriR 0,fc' 

FLFxslR(:^.32i?) f (RELO. INTER, ONLY) 

FXFL»1(^F34P t fRELO, INTER, ONLY) 



J)ALC FDVO« FDIV 0»e! 
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FLOATIMR MP INSTRUCTIONS 

WITH AM ACCUHULATUR 

,DMRA FLDA« ?l2(^?iPi0 

,DMRA FSTA« 5^4gPiP!W 

WITHOUT AN ACCUMULATOR 



.DMR 
,OMW 

,DM» 
.DMR 
,DMR 

,OMR 



FJMP» 
FJSRi 
FISZ« 
FOSZ* 
FFLO« 
FL03- 
FST3- 
FFIX» 



(^64!S00 

P!74000 



SPFCIAL FUNCTION INSTRUCTIONS 

.OUSP FEXT» *» 

.DUSR FIC2* 1040i?!pi 

,DUSR FIC3« 110Pif«l« 

.OUSR FHLT» 114000 

INSTRUCTIONS REQUIRING ONE ACCUMULATOR 

,0IAC FFDC- 14fl|05i0 

,.DIAC FDFC» 120000 

,DIAC FFDCF*140001 

,DIAC FDFCT»120001 



SKIP OEFTNTTIONS 



.DUSR 


FSGT" 


1 


.DUSR 


FSLTi 


2 


.OUSR 


FSN9" 


3 


.DUSR 


FSZR- 


4 


.OUSR 


FSGE" 


5 


.OUSR 


FSLE- 


6 


.DUvSH 


FSKPi 


7 
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'I OI-FINfE THF PRECISinN INSTRUCTinN 



.DID 



FPRCBi^6C(?l?c^ ; fRELO, INTER. ni^LY) 



t DEFINE THE FOi^TRAN INTERPRETER MNEMONICS 

» (ONLY AVAILABLE WITH THE RELOCATABLE INTERPRETER) 



,OALC FCEQ»19IP1701 f 

.DALC FCLE«ll»kil7? t 

,UALC FCLT«1«^'16? » 

.DALC FSTMilBf^iej ; 

,D6LC FLDM«lPi|?)63 f 

,D«LC FADMBld?ll65 I 

.OAlC FSMR«n0167 I 

.DALC FSRM«19iei71 > 

.OAlC FmLM«10ic^173 » 

.DALC F0MRilP)(^l75 I 

.DALC FDRM«lPt((! 1 77 f 

.DIJSR FSNGL«FPRC P 

,OUSR FDBLE«FPRC 4 



EQUALITY TEST 
LESS THAN OR EQUAL 
LESS THAN TEST 



TEST 



STA TO ADDRESS FOLLHWlNG 
LDA FROM ADDRESS FOLLOWING 
ADO FROM ADDRESS FOLLOWING 
R - MEMORY TO R 
MEMORY - R TO R 
MULTIPLY BY ADDRESS FOLLOWING 
MEMCRY/R TO R 
R/MEMORY TO R 

? SINGLE 
f DOUBLE 



.EOT 
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NAME! OSID.SR PART NUMStRl 9l<}(i|.00i 484 

description: operating SVSTEMS instruction DfFINITIONS 



DOCUMENT NO, 

I^?7..(?0PI164 
007-00fl285 
K07»!?)0P!322 



uuLU'^tNTATlON RtKfcRfcNCESI 
TITLE 

EXTENDED ASSEMBLER 
RODS EKTENHEO ASSEMBLER 
SOS EXTENDED ASSEMBLER 

REVISION HISTORY: 

«EV. DATE 

^'^ C«4/27/73 



COPYRIGHT rC) DATA GENERAL CORPORATION, 1973 
ALl RIGHTS RESERVED. 



E-9 



f OEFIMe AS PERHANEMT SYMBOLS ALL MONITOR RELATED SYMBOLS 

I DEFINE THE NOVA SYSTEM CALL 

,DUSP .SYSTMs JSR •I? 

» DEFINE THE USER STACK POTKTER LOCATION 
.DltSP USP« 16 

r OEFINF THE MOnITOP CALLS 



I COMMANDS WHICH 00 NOT RECUIRE DEVICE ACTION OR CHANNEL NUMBER 



• DUSR 
,OUSR 
.OIISR 
,nt)SR 
.DUSR 

.nusR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

.DUSR 

IRESER 

^RESER 



,CREAT» 
.OELET" 
.RENAHb 

,MEM» 
.BREAKS 

.RUSE* 

.DIR« 

.EXEC" 

.INITb 

.RTN» 

.RESET" 

,ERTN» 

^CRAND" 

.GCHAR" 

.PCHAR" 

.DELAY- 
.MEMlB 
.CCONi 
.EXFG" 



VE 
VE 



(?IB7 

IB7 

?B7 

387 

4B7 

587 

6B7 

7^7 

1087 

UB7 

12B7 

1587 

16P7 

17B7 

2PB7 

?IB7 

22B7 

4187 

43P7 

44B7 

45B7 



CREATE FILE 

DELETE FILE 

RENAME A FILE 

RETURN MEMORY LIMITS 

BREAK 

RELEASE A DEVICE 

CHANGE BASE DIRECTORY 

EXECUTE A PROGRAM OVERLAY 

INIT DISK DEVICE 

SYSTEM RETURN 

I/O RESET 

ERROR RETURN FROM COMMAND 

CREATE RANDOM 

GET TTY CHAR 

TTY PUT CHAR 

WAIT N CYCLES 

ALLOCATE MEMORY INCREMENT 

CREATE CONTIGUOUS 

EXECUTE FOREGROUND 
IOCS 
IOCS 
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COMMANDS WHICH REQUIRE CHANNEL NUMBER 



.010 
.nio 

• I.' Jt 'J 

,010 

,nio 

.DIO 
.DIO 
.DIO 

.Din 

.DID 
,DIO 
.010 
.DIO 
.010 
,010 
,010 
.010 

.DIO 
.010 
.010 
,010 
.010 
.010 
,DI0 
.010 



,»OPPN" 
.MTOPOi 

rt t* A n 1. a 

^ M V U r- i>i *» 

.CHATf?« 

.GTATR- 

.NDB = 

.inR3« 

.APPENOi 

,OP£N« 

.CLOSES 

.ROS* 

,WOL« 

.RORai 

.MRS" 

,WRI.» 

,WRR« 

.OVLDD" 

.SCALL" 

.MTOIO" 

.SPOS« 

.GPOSb 

.EOPENi 

,TOPEN« 

.CHLATi 

.CHSTS* 



?3B7 
23B7 

26B7 
?797 
13B7 
14B7 
!!?587 
30R7 
31B7 
32B7 
3387 
34B7 
3587 
36B7 
37B7 
apB7 

42P7 
46B7 
4787 

5087 
51B7 
52B7 
f»3R7 

5487 



OPEN FOR READING 

OPEN MAG TAPE FOR DIRECT I/O 



ft ft «r fc, 

M r c n< 



A If IT n I A k> e 



CHANGE THE 
GET THE FI 
READ BLOCK 
WRITE BLOC 
OPEN FILE 
OPEN FILE 
CLOSE FILE 
READ SEQUE 
READ SEQUE 
READ RANOO 
WRITE SEQU 
WRITE SEQU 
WRITE RAND 
LOAD OVERL 
GENERAL CA 
MAG TAPE 
SET FILE P 
GET FILE'S 

open for e 
transparen 

CHANGE LiN 
GET CHAKlNE 



FILE AT 
LE/DEVIC 



TRIBUTES 

E ATTRIBUTES 



FOR APPENDING 



NTIAL CH 
NTIAL LI 

M 

FNTIAL C 
ENTIAL L 
OM 

AV 

LL 

IRECT 1/ 
OSITION 

CURRENT 
XCLUSIVE 
T OPEN 
K ACCESS 
L STATUS 



ARACTERS 

NE 

HARACTERS 

INE 



POSITION 
USE 

ATTRIBUTES 
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t THE 



FOLLOWlMG 


CALLS ARE SCALLS 


.DUSR 


,GHR7« 


.SCALL 


PI 


.DUSR 


.DUCLK« 


.SCALL 


1 


.OIJSR 


.RUCLK* 


.SCALL 


2 


.niJSf? 


.GTQD» 


•SCALL 


3 


• DUSR 


.STOOb 


.SCALL 


4 


,nusR 


.SDAY» 


.SCALL 


5 


.DUSR 


.GDAY* 


.SCALL 


6 


.DUSR 


.IDEF« 


.SCALL 


7 


.DIJSH 


.IRMVb 


.SCALL 


10 


,OUSF? 


.SPKL" 


.SCALL 


11 


.DUSR 


.SPOAb 


•SCALL 


1? 


.ntisR 


.SPEA« 


.SCALL 


13 


.DUSR 


• ENO" 


.SCALL 


14 


.DUSR 


.CPART» 


.SCALL 


15 


.DUSR 


.CDIRr 


.SCALL 


16 


.OUSR 


.LINK. 


•SCALL 


17 


.DUSR 


.ECJIVB 


•SCALL 


2Pi 


.DUSR 


.GOIRS« 


.SCALL 


21 


.DUSR 


.SYSiB 


.SCALL 


22 


,OUSR 


.WCHARi 


.SCALL 


23 


.DUSR 


.ICHNb 


.SCALL 


24 


.DUSR 


.WRCMN" 


•SCALL 


25 


.OUSR 


.ROC^^NB 


.SCALL 


26 


.DUSR 


.DDISb 


.SCALL 


27 


^OUSR 


.OEBLB 


.SCALL 


3PI 


.DUSR 


.DEBL" 


•SCALL 


31 


.DUSR 


.DDISb 


.SCALL 


32 


.DUSR 


.RDOPRB 


.SCALL 


33 


.DUSR 


.WRDPRb 


.SCALL 


34 


.DUSR 


.STMAPB 


.SCALL 


35 


.OUSR 


.GCINB 


.SCALL 


36 


.DUSR 


.GCOUTB 


.SCALL 


37 


.DUSR 


.STATb 


.SCALL 


4P 


.DUSR 


.ECLRb 


.SCALL 


41 


.DUSR 


,TC«ETb 


•SCALL 


42 


.OUSR 


.TCRNOb 


•SCALL 


43 


.DUSR 


.TCCDNB 


•SCALL 


44 


.OUSR 


.FGNDb 


.SCALL 


45 


.OUSR 


.GMEMb 


.SCALL 


46 


.DUSR 


.SMEHb 


.SCALL 


47 


.DUSR 


.eooTB 


.SCALL 


51^ 


.DUSR 


.moIRb 


.SCALL 


51 


.DUSR 


.GCHNs 


.SCALL 


52 


.DUSR 


.ULNKb 


.SCALL 


53 



IGET CLOCK FREO 

IDEF USER CLOCK 

IREMAOVE USER CLOCK 

IGET TOD 

ISET TOD 

»SET DAY 

»GET DAY 

IDEFINE DEVICE INT 

IREHOVE OEV INT 

fSPOOL KILL 

ISPODL DISABLE 

ISTREAM OUTPUT 

»CREATE PARTITION 

ICREATE SUBDIRECTORY 

ILINK ENTRY 

ICHANGE DIRECTORY SPECIFIER 

IGET DIRECTORY SPECIFIER 

fSOS COMPATIBLE CALL 

FWAIT FOR TTY CHAR 

UNIT COMMON 

IWRITE TO COMMON 



lOISABLE INT 
IENA8LE INT 
lENABLE MAPP 
IDISABLE MAP 
;reao OPERAT 
IWRITE OPERA 
inCH MAP REQ 

pget console 
;get console 
iget status 

IRELEASE A F 
ITRANSPARFNT 
^TRANSPARENT 
TRANSPARENT 
IIS THERE A 
IGET MEM PAR 
ISET MEM PAR 
IJNVOKE HIPB 
IGET MASTER 
IGET A FREE 
IDELETE A LI 



(CONTL A,C,F) 

ED npy ACCESS 
PEo'dEV ACCESS 
OR 
TOR 

FOR USER 

INPUT DEV 

OUTPUT OEV 
OF FILE 
ILE 

.CREATE 

.CRANO 

,CCON 
FOREGROUND 
TITIONS 
TITIONS 
POT 

OIR. SPECIFIER 
CHANNEL 
NK ENTRY 



.END 
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APPENDIX F 
PERMANENT SYMBOLS 
Permanetnt Symbol Pseudo-op (directive) Value 



.ARGC 

.BLK 

.COMM 

.CSIZ 

.DALC 

.DLAC 

.DIO 

.DIOA 

.DMR 

.DMRA 

.DO 

.DUSR 

.END 

.ENDC 

.ENT 

.ENTO 

.EOT 

.EXTD 

.EXTN 

.EXTU 

.GADD 

oGLOC 

.IFE 

.IFG 

.IFL 

.IFN 



No 


Yes 


No 


Yes 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Ye^ 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 



F-1 



PERMANENT SYMBOLS (Cont'd) 
Permanent Symbol Pseudo-op (directive) Value 



.LOG 


Yes 


Yes 


. MCALL 


No 


Yes 


. MACRO 


Yes 


No 


. NOCON 


Yes 


Yes 


. NOLOC 


Yes 


Yes 


. NOMAC 


Yes 


Yes 


.NREL 


Yes 


No 


.PASS 


No 


Yes 


.POP 


No 


Yes 


.PUSH 


Yes 


No 


.RDX 


Yes 


Yes 


• RDXO 


Yes 


Yes 


,TITL 


Yes 


No 


.TOP 


No 


Yes 


.TXT 


Yes 


No 


.TXTE 


Yes 


No 


.TXTF 


Yes 


No 


.TXTM 


Yes 


Yes 


,TXTN 


Yes 


Yes 


.TXTO 


Yes 


No 


,XPNG 


Yes 


No 


.ZREL 


Yes 


No 



F-2 



MACRO ASSEMBLER ERROR CODES 



Up to three error codes may be output per source line. The error codes are 
output in the first three character positions of the listing line. The first 
error encountered causes a code to be placed in column 3, the second in column 
2, and the third in column 1, 



Code Error 

A Addressing error 

B Bad character 

C Macro error 

D Radix error 

E Equivalence error 

F Formatting error 

G Global symbol error 

I Parity error on input 

K Conditional or repetitive assembly error 

L Location counter error 

M Multiply defined symbol error 

N Nun:iber eixor 

G Overflow field or stack error 

P Phase error 

Q Questionable line error 

R Relocation error 

U Undefined symbol error 

X Text input error 



MACRO ASSEMBLER USER'S MANUAL 



Where there are a large number of page references for a given 
topic, the primary page reference will be Indicated by an asterisk 
(*) following the reference. 



INDEX 



< 
> 

> = 
<> 
< 

? 
% 
$ 
# 



2-1.4-40,5-1* 



or 2-3,2-7,3-1* 

and 2-3,2-7,3-1* 

addition 2-3,2-7,3-1* 

su btractio n 2-3,2-7.3-1* _ 

muMplicatioQ 2-3,2-7,3-1* 

division 2-3,2-7,3-1* 

equal to 2-3,3-1* 

less than or equal to 2-3,3-1* 

less than 2-3,3-1* 

greater than 2-3,3-1* 

greater than or equal to 2- 3, 3- 1 * 

not equal to 2-3,3-1* 

> angle brackets text 4-31 
notation convention ill, iv 

synnbol character 2-13 

macro definition teanninator 

relocation flag 1-5 

special atom 2-14*,A-9 

special atom 2-14*, A-9 

special atom 2-15 

carriage return 

effect in special integer 2-8, 2-9 
line terminator 2-1,2-4*, 2-7,2-10 
notation convention iii 

form feed 

line terminator 2- 1, 2-4 
notation convention iii 

label indicator 3-18 
notation convention iv 
break atom 2-4 

break atom 2-1,2-4,2-7,2-10 
comment indicator 2-1 

integer format delimiter 2-9 
relocation flag 1-5 

integer format delimiter 2-9 
relocation flag 1-5 



[] 



AA 
\ 






break atom 2-4 
in equivalence sjranbol 3-19 
notation convention iv 
relocation flag 1-5 

relocaaon Ha^ 1-5 

break atoms 2-4 

in actual argument formatting 
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3-8 



( ) break atoms 2-4 

denoting value of pennanent symbol 
in clarification of meanings 3-3 
in expression evaluation 3-2 

character in symbol 2-13 
decimal point 2-6,2- 10 
permanent symbol 4-18 



break atom 2-4 

argument position indicator 5-1,5-2 

non-interpretation of character 2-7,*2- 10,2-12,5-1 

symbol type 1-7 

incorrect parity character 

underscore convention iii 

ellpsis convention ill 

optional convention ill 

alternative convention Iv 
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error code A- 2 
global switch 3-9,6- 
numeric 2-7 



absolute 



address 1-8 
address in MRI 3-15,3-16 
location counter 3-18 
one evaluation 3-2,3-6 
value of expression 3-5 
zero evaluation 3-2,3-6 

accumulator 

in ALC instruction 3-11 
in I/O instruction 3-12,4-11 
in MRI instruction 3-14,4-13 
in instruction having 3-13 

actual argument to macro 1-2,4-40,5-1,5-4* 



Index 1 
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ADC 3-10 

ADD 3-10 
addition 3-1 
addressing 

absolute 3-15,1-8 

direct 3-15 

error in A-2 

evaluation 3-16 

indirect 3-15 

page zero 3-15 

relative 1-7,3-15 

ALC instruction (see arithmetic and logical) 
alphabetic 

in symbol 2-13 

lower case translation to upper case 2-3 

AND 3-10 

ANDlng 3-1 

apostrophe 

in integer formatting 2-9 
relocation flag 1-5 

.ARGCT 4-40 

argument 

actual 1-2,4-40,5-1,5-4* 
formal (or dummy) 1-2,5-1,5-4* 
number of actual 4-40 

arithmetic and logical instruction (ALC) 
# sign used for no load In 2-14 
defining semi- permanent symbol for 4-4,4-7* 
definition of 3-10 
format 3-10,4-7 



ASCII 



character set 2-2 
input to assembler 1-3 



assembler 

command line invoking 6-1 

definition 1-1,1-2 

differences between Extended and Macro i 

error codes App. A 

files that make up the 6-1 

loading onto disk 6-1 



assembly 



definition of 1-1 

language 1-1 

macro 1-2, Chapt 5. 

output of 1-4 

cross reference listing 1-6 
error listing 1-7 
program listing 1-4 
relocatable binary file 1-4 



assembly (cont'd) 

processing input 1-1,1-3*, 1-7, 2-1 

normal input 2-2 

scan of input 1-3*, 1-7, 3-18 

string input 2-1 

asterisk 2-14*, A-9 

atoms 

break atoms 2-4 
definition of 1-7, 2-3 
numbers 2-5 
operators 2-3 
special 2-14 
symbols 2-13 
terminals 2-3 
transparent 2- 14 

B 

bit alignment operator 2-4,2-7,3-1,3-3* 
error code 2-3, A-2* 
local switch 6-2 
numeric 2-7 

bad character error A-2 

bit alignment 2-4,2-7,3-1,3-3* 

.BLK 4-16*, A-6 

block 

entry (.ENT) B-l,B-3* 

external displacement (. EXTD) B- 1, B-4* 

external normal (.EXTN) B-l,B-4* 

global addition (. GADD) B- 1, B-6* 

global start and end (. GLOC) B-l,B-7* 

labeled COMMON (. COMM) B- 1 , B-6* 

local symbol B-1, B-5* 

overlay (. ENTO) B-2,B-3* 

relocatable data B-1, B-3* 

start B-1, B-5* 

title (.TITL) B-1, B-5* 

unlabeled COMMON (. CSIZ) B- l,B-7* 

break atom 2-4 

bjrte 

packing 4-3014-32* 
relocatable value 3-5, 3-4*, 1-5 
termination of string 4-3-3 
to store character 4-30 



carry field of ALC 3-11*, 4-8 

error code A-3 

numeric 2-7 

pulse field of I/O 3- 1 3* , 4 - 10, 4 - 1 1 
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INDEX 



carriage return 

as break atom 2-4 

as line terminator 2-1, 2-4*, 2-7,2-10 

in text string 4-30 

notation convention iii 

carry field of ALC 3-11*, 4-8 



character 

input as a string of 2-1 

of symbol 2-13 

s t o r a ge of strings of 4-30^- 

checksum of block B- 2 



colon 2-4 

COM 3-10 

.COMM 1-7,4-21*. 4-2 8 

comma 2-4 

command line for assembly Chapt. 6 

comment 2-1 

conditional assembly 
error code A-6 
.IFE, .IFG, .IFN, .IFL 4-37 
listing and listing suppression 4-4 2 

.CSIZ 4-2i 

D 

double precision flag 2-10 
error code A-4 
numeric 2-7 

.DALC 4-4, 4-7* 

data, relocatable block B-3 

decimal point 2-6,2-10 

device code field of I/O 3-12, 3-17 

DIA 3-12 

.DIAC 4-4,4-9* 

DIB 3-12 

Die 3-12 

.DIO 4-4,4-10* 

.DIOA 4-4,4-11* 



direct address 3-15,5-21 



displacement 

external 4-25*,B-4 

field of MRI 3-14,4-12*,4-13 
symbol in . EXTD 4-20 ___ 



division 3-1 

.£»4R 4-4,4.12* 

.DMRA 4-4,4-13* 

.DO 4-36*, 4-37,4-38 

DOA 3-12 
DOB 3-12 
DOC 3-12 
dollar sign i, 5-20* 

double 

precision flag 2-10 

precision integer 
range A-7 

representation in core 2-5 
source program format 2-10 

storage word 3-4 

DSZ 3-14 

dummy argument of macro 1-2,5-1,5-4* 

• DUSR 4-4,4-14* 

E 

error code A-4 
floating point indicator 2-11 
global switch 6-1 
numeric 2-7 

EN symbol type 1-7 

end 

of input file (. EOT) 4-35 

of program (.END) 4-34*, 4-29,4-3 5 

.ENDC 4-3^,4-37,4-38* 

.ENT l-7,4-2"jr.4-2s,4-2'a,B-l,B-3 

.ENTO l-7,4-2a*,4-2«,B-2,B-3 

entry 

block B-l,B-3* 
naming (.ENT) 4-2-3 
symbol error A-5 
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INE£X 

EO symbol type 1-7 

.EOT 4-35 

equal sign 2-4,3-18 

equal to 3-1 

eqtiivalencing 3-18*, A-4 

error 

command lii» 6-2 
file output 1-4,1-5,1-7 
output codes 



A 


A-2 


B 


A-2 


C 


A- 3 


D 


A-4 


B 


A-4 


F 


A-5 


G 


A-5 


I 


A-6 


K 


A-6 


L 


A-6 


M 


A-7 


N 


A-7 





A- 8 


P 


A-8 


Q 


A-9 


R 


A-9 


U 


A-9 


X 


A-10 



evaluation of expression Chapt 3 

expression 

evaluation 3-2 ff 

format 3-1 

in Uteral 5-21 

in text string A-10 

operators of 3-1 

relocation properties of 3-4 

.EXTD l-7,3-15.4-21,4-25*,4-23,B-4 

external 

blocks B-l,B-4* 
displacement (. EXTD) 4-25, B-4 
normal (. EXTN) 4-26,8-4 
symbol error A-5 

.EXTN l-7,4-21,4-26*,4-23,4-24,4-28,B-4 

.EXTU 4-27 



error code 2-10,4-6,A-5*,A-8 
numeric 2-7 

field of Instruction 

ALC 3-11,4-7 

implied by semi-permanent symbol 3-9 
instruction having accumulator 3-13,4-9 
I/O with accumulator 3-12,4-11 
I/O without accumulator 3-12,4-10 
MRI with accumulator 3- 14, 4-13 
MRI without accumulator 3- 14, 4- 12 
overflow error in A-8 



file 



flag 



symbol table 6-3 
termination of 4 - 3:4, 4-35 



error 1-4, 1-5 
relocation 1-4, B-2 

floating point number 

range of magnitude 2-6,A-7 
representation in core 2-5 
source program format 2-11 

form feed 

break atom 2-4 

line terminator 2-1 , 2-4 

notation convention iU 

format error 2-10, 4-6, A-5* 

G 

error code A-5 
numeric 2-7 

.GADD 4-21,4-28*, 4-23, B-l,B-6 

generating unique labels 5-20 

global 

addition block B-l,B-6* 
start and end blocks B- 1 , B- 7 * 
switch 6-1 
symbol 3-9 

.GLOC 4-29*, 4-23, B-l,B-7 

greater than 3-1 

greater than or equal to 3-1 

H 

numeric 2-7 

HALT 3-17 
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hexadecinia.1 number 2=^ ' ^ 

I 

error code A-6 
numeric 2-7 

.IFE 4-3 7*. 4-38 

. IFG 4-37*. 4-38 

. IFN 4-37*, 4-38 

INC 3-10 

index field of MRI 3-14*. 4-12. 4-13 

indirect addressing 2-14,3-15 

input 

error code A-6 
to assembly 1-3 ff 

normal mode 2-2 

string mode 2-1 

instruction 

definition 3-9 

format 

ALC 3-10 
I/O with AC 3-12,4-11 
I/O without AC 3-12,4-10 
MRI with AC 3-14,4-13 
MRI without AC 3-14,4-12 
with accumulator 3-13,4-9 

list of App. E 

mnemonic 1-1 

types of 3-10 

INTA 3-13 

INTDS 3-17 

integer 

characteristic of floating point number 2-5 
core representation 2-5 
double precision source representation 2-10 
single precision source representation 2-6 to 2-9 

INTEN 3-17 

interprogram communication pseudo-ops 4-21 to 4-29 

lORST 3-17 

ISZ 3-17 



J iiuuieru; z- / 

JMP 3-14 

JSR 3-14 

K error code A-6 

L 

error code A-6 

global switch 6-1 

local switch 6-2 

shift field of ALC 3-11,4-8 

label 

generation of 3-character 5-20 
in source line 3-18 

labeled COMMON l-7,B-l,B-6* 

LC 1-4, l-5M-7,3-9,3-15, 3-18 

LDA 3-14 

less than 3-1 

less than or equal to 3- 1 

line feed character 1-3,2-8 

line of source input 1-3 



listing 



cross reference 1-6 

error 1-7 

program 1-4 

suppression of 

by ** atom 2-15 
by . NOCON 4-42 
by . NOLOC 4-43 
by . NOMAC 4-44 
overriding sujq)ressiQii 6-1 
literal 

in MRI 5-21 

page zero resolution i, 5-21 

loading 1-7 

.LOC 4-17*,4-2ftA-6 

local symbol 3-9 



Index 5 
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locatirai counter 

absolute, ZREL, or NREL 3-18 
in MRI addressing 3-14, 3-15 
in program listing 1 -4, 1 -5 
incrementing the 3 -9 
relaticn to label 3-18 
relative 1-7 
setting the 4-17 
value (.) 4-18 



M error code A -7 

MAC command line Chapt. 6 

MAC.PS permanent symbol table file 6-3 

MAC.ST symbol and macro definition table 6-3 

machine language 1-1, 1-2 

macro 

actual arguments 5-1, 1-2, 4 -4 ft 5-4* 
call 

arguments to 5-4 

definitirai of 1-2, 5-1, 5-4* 

format 5 -4 

value 4-41 
carriage return after symbol definition 5-2 
continuation after interruption 5-3 
deflnittffli 1-2, 4-39. 5-1* 
definition string 2 -1 
error code A -3 
examples 

FACT 5-9 

OR 5-6 

PACK 5-11 

VFD 5-14 

XOR 5-7 
ejfpansion of 1-2, 5-1* 
expansicxi listing 

format 5 -5 

suppressicn of 4-44*, 5-5 
formal (dummy) arguments 5-1, 1-2, 5-4* 
interrupted definition 5-3 

positional value of actual argument (t ) 5-2, 5-4 
processor 1 -2 

pseudo-op .MACRO 4-39,* 5-1 
semi -permanent symbol fQe s App. E 
symbol associated with 5-1 
termination of definition (%) 2-1, 5-1* 
uninterpreted character in definition ( -«- ) 5-1 

• MAIN 4-1 

mantissa of floatingpoint 2-5 

.MCALL 4-41 



memory reference instruction (MRI) 
fields of 3-14*. 4-12, 4-13 
format 3-14*, 4-12, 4-13 
illegal address in A -2 
indirect address setting 2-14 

MOV 3-10 

MSKO 3-13 

multipllcatirai 3-1 

multiply defined symbol error A -7 

N 

error code A-7 
global switch 6 -1 

named COMM(»I 1-7, B-1, B-6* 

naming a program 4-1 

NC symb<d type 1-7 

NEC 3-10 

NIO 3-12 

.NOCON 4-42 

.NOLOC 4-43 

.NOMAC 4-44 

noloadof ALC 2-14 

normal 

external 4-26 
input mode 2-2ff 

normal relocation (NREL) 
ccmstant 3-4 
in MRI 3-16 
location counter 3-18 
mode, setting the 4-19 
pseudo-op (.NREL) 4-19*, 4-29 
value of expression 3-5 

not equal to 3-1 

notation 

conventions of manual iii 
variables iv 

.NREL 4-19,* 4-29 

nuU character 1-3, 2-8 
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number 

character in symbol 2-13 
class of atom 2-3 
double precisicm integer 2-10 
error A -7 
floating point 2-11 
hexadecimal 2-13 
internal representation 2-5 
single precisicm integer 2-6 
source representation 2-6 
special format integers 2-8, 2-9 
/symbol recognition 2 -7 
use of 2:^ 



O 



carry field of ALC 3-11, 4-8 
error code 4-6, A -8* 



object program 
definitimi 1-2 
output of assembly 



1-3 



operand 

definitian 3-1 
relocation properties 3-4 

ope rati Ml code 3-8 

operator 

as class of terminals 2-3 
list of 2-3, 3-1 
precedence 3-2 
use in e:q)ression 3-1 ff 

ORlng 3-1 

output of assembly 1 -3ff , App, B 

overflow error 4-6, A -8* 

overlay (.ENTO) 4-24? B-3 



error code A -7, A -8* 

pulse field of I/O 3-13*, 4-10, 4-11 

packing of bytes 4-3 2 

page zero relocation (ZREL) 
constant 3-4 
inMRI 3-16 
location counter 3-18 
mode, setting the 4-20 
pseudo-qp (. ZREL) 4-20 
use for literals 5-21 

parentheses 

as break character 2-1 
denoting value instead of pseudo-op 
in clarifying meanings of data 3-3 
In expressiffli evaluation 3-3 



3-8 



ttJDEX 

r / 

error code for Incorrect A -6 

in text string 4-30 

listing character (\ ) for incorrect 1-3 

pass 

assembly 1 -7 
value (.PASS) 4-48 

PC 3-14, 3-15 
permanent symbols 

. 4-18 

,ARGCT 4-40 

list of App. F, D 

.MCALL 4-41 

.PASS 4-48 

• POP 4-46 

pseudo-<^s (see pseudo-qj list) 

.TOP 4-47 

types of 3-7, 4-1 

phase error A -7, A -8* 

pound sign 2-14*, A-9 

.POP 4-17, 4-45, 4-46*. A-8 

precedence of evaluaticm i, 3-2ff 

pseudo-pp 

file terminatuig 4 -34 

interprogram communication 4-21 

listing 4-42 

location counter 4-16 

macro 4-39 

radix 4-2 

repetition and conditional 4 -36 

stack 4-45 

symbol taUe 4-4 

text 4-30 

title 4-1 

pseudo-op list 
.BLK 4-16 
..COMM4-21 

• GSIZ. 4-22 
.JDALC 4-7 
.DIAC 4-9 
.DIO 4-10 

• DIQA 4-11 
.DMR 4-12 
.DMRA 4-13 
.DO 4-36 

• DUSR 4-14 
.END 4-34 
.ENDC 4-38 
.ENT 4-23 

• ENTO 4-24 
.EOT 4-35 
.EXTD 4-25 
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pseudo-op list (continued) 
.EXTN 4-26 
.EXTU 4-27 
.GADD 4-28 
.GLOC 4-29 
.IFE 4-37 
.IFG 4-37 
.IFL 4-37 
.IFN 4-37 
.LOG 4-17 
.MACRO 4-39 
.NOCCW 4-42 
.NOLOC 4-43 
.NCMAC 4-44 
.NREL 4-19 
.PUSH 4-45 
.RDX 4-2 
.RDX0 4-3 
.TITL 4-1 
.TXT 4-30 
• TXTE 4-30 
.TXTF 4-30 
.TXTM 4-32 
.TXTN 4-31 
.TXTO 4-30 
.XFNG 4-15 
.ZREL 4-20 

FTP 3-17 

PTR 3-17 

.PUSH 4-45*, A -8 

push-down stack 4-45 to 4-47 

Q error code A -7 
question mark 2-13 
questicBiable line error A -7 
quotation mark 2-13 



error code A -9 

shift field of ALC 3-11, 4-8 

radix 

50 format for symbols B-2, App. C * 
changing input (.RDX) 4-2 
changing output (. RDXO) 4-3 
range 2-6, 2-10, 4-2, A-4* 

.RDX 4-2 

.RDXO 4-3 



READS 3-13 

relational 

expression 4-36 
operator 3-2 

relative address 

inMRI 3-14, 3-15. 3-16 
location counter 1 -7 
relocated by loade r 1-4,1-8 
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relocation 

constant 3-4 
definition 1-7, 1-8 
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SNC 3-17 

SNR 3-17 

source program 
definition 1-2 
lines of 1-3 
scan 1-3 

space (A } 2-4 

special atom 
@ 2-14 
# 2-14 
*• 2-15 
as class of atom 2 -3 

square brackets 

as break atoms 2 -4 
in macro call 5-4 

STA 3-14 

stack 

determining current value (m 4-47 
pq)ping values from 4-46 
saving values on 4-45 
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